wv_search_businesses
Pack: wv-sos-business · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/wv_search_businesses for the schema, then POST the same URL with its arguments for the data.
Search the West Virginia Secretary of State business organization records by name.
Tool description as the model sees it
Search the West Virginia Secretary of State business organization records by entity name. The register matches names that contain the text you give, so a short word returns many organisations; each row carries match = exact | legal_form_variant | name_prefix, ranked in that order, and hits counts only the exact and legal_form_variant rows. Tolerant of case, ”&” vs “and” and the legal-form spelling (Inc / Incorporated, LLC / L.L.C.). Returns each organisation’s file_number (the register’s organization id), name, entity type, locale (domestic = formed in West Virginia, foreign = formed elsewhere and registered there), profit class, status, and effective, established and termination dates and reason. The register publishes no status column: status_normalized is active when no termination is recorded, inactive otherwise. status_basis says so on every row (always inferred). Fictitious-name, trademark and emblem registrations are included and marked in name_kind; they are not companies. total_in_register is the number of organisation rows the register returned. Entity-level only: no individuals’ names and no addresses. Each call takes roughly 3 to 6 seconds, because the register’s form must be loaded and submitted after a short pause.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
name | string | yes | Entity name, e.g. “Acme Alternator, LLC”. |
active_only | boolean | no | Only organisations with no termination recorded. Default false. |
limit | number | no | Maximum rows returned (1-100, default 25). |
Example call
Arguments
{
"name": "Acme Alternator, LLC",
"limit": 3
}
curl
curl -X POST https://gateway.pipeworx.io/wv-sos-business/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"wv_search_businesses","arguments":{"name":"Acme Alternator, LLC","limit":3}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('wv_search_businesses', {
"name": "Acme Alternator, LLC",
"limit": 3
});
Response shape
Always returns: query, results, source, data_as_of
| Field | Type | Description |
|---|---|---|
query | string | The name searched |
hits | number | Rows that match exactly or by legal-form spelling |
total_returned | number | Rows in results |
total_in_register | number | Organisation rows the register returned |
results | array | |
empty_reason | string | Present when no rows: no_match_in_register |
register_searched | boolean | True when the register answered |
source | string | Publisher and dataset |
data_as_of | string | Date of the live read |
Full JSON Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "The name searched"
},
"hits": {
"type": "number",
"description": "Rows that match exactly or by legal-form spelling"
},
"total_returned": {
"type": "number",
"description": "Rows in results"
},
"total_in_register": {
"type": "number",
"description": "Organisation rows the register returned"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"file_number": {
"type": "string",
"description": "Organization id in the West Virginia register"
},
"name": {
"type": "string",
"description": "Organisation name"
},
"entity_type": {
"type": [
"string",
"null"
],
"description": "Entity type label, null for an unrecognised code"
},
"entity_type_code": {
"type": "string",
"description": "The register's type code, e.g. C, LLC, PLC"
},
"locale": {
"type": [
"string",
"null"
],
"description": "domestic (formed in West Virginia) or foreign"
},
"name_kind": {
"type": "string",
"enum": [
"current",
"fictitious",
"trademark",
"emblem"
],
"description": "current = a real organisation; the others are not companies"
},
"status": {
"type": "string",
"description": "Termination reason, or a note that none is recorded"
},
"status_normalized": {
"type": "string",
"enum": [
"active",
"inactive"
],
"description": "active when no termination is recorded"
},
"profit_class": {
"type": [
"string",
"null"
],
"description": "Profit or Non-Profit"
},
"effective_date": {
"type": [
"string",
"null"
],
"description": "ISO date"
},
"established_date": {
"type": [
"string",
"null"
],
"description": "ISO date"
},
"termination_date": {
"type": [
"string",
"null"
],
"description": "ISO date"
},
"termination_reason": {
"type": [
"string",
"null"
],
"description": "Why the organisation was terminated"
},
"match": {
"type": "string",
"enum": [
"exact",
"legal_form_variant",
"name_prefix"
],
"description": "How the name matches the query"
},
"status_basis": {
"type": "string",
"enum": [
"inferred_no_termination_recorded",
"inferred_termination_recorded"
],
"description": "Always inferred: the register has no status column, so status_normalized comes from whether a termination is recorded."
}
}
}
},
"empty_reason": {
"type": "string",
"description": "Present when no rows: no_match_in_register"
},
"register_searched": {
"type": "boolean",
"description": "True when the register answered"
},
"source": {
"type": "string",
"description": "Publisher and dataset"
},
"data_as_of": {
"type": "string",
"description": "Date of the live read"
}
},
"required": [
"query",
"results",
"source",
"data_as_of"
]
}
Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the wv-sos-business pack
{
"mcpServers": {
"wv-sos-business": {
"url": "https://gateway.pipeworx.io/wv-sos-business/mcp"
}
}
}
See Getting Started for client-specific install steps.