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

NameTypeRequiredDescription
namestringyesEntity name, e.g. “Acme Alternator, LLC”.
active_onlybooleannoOnly organisations with no termination recorded. Default false.
limitnumbernoMaximum 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

FieldTypeDescription
querystringThe name searched
hitsnumberRows that match exactly or by legal-form spelling
total_returnednumberRows in results
total_in_registernumberOrganisation rows the register returned
resultsarray
empty_reasonstringPresent when no rows: no_match_in_register
register_searchedbooleanTrue when the register answered
sourcestringPublisher and dataset
data_as_ofstringDate 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.

Regenerated from source · build November 18, 2026