wv_get_business

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_get_business for the schema, then POST the same URL with its arguments for the data.

West Virginia Secretary of State business organization by organization id.

Tool description as the model sees it

One West Virginia Secretary of State business organization by its organization id (file_number from wv_search_businesses): name, entity type, locale, profit class, status, dates and termination reason, plus business purpose (the register’s industry code and text), charter county, charter state and control number. Entity-level only: no officers, members, organisers, agents or addresses are returned. found is false only when the register answered and holds no such id.

Parameters

NameTypeRequiredDescription
org_idstringyesOrganization id, digits only, e.g. “253587”.

Example call

Arguments

{
  "org_id": "253587"
}

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_get_business","arguments":{"org_id":"253587"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('wv_get_business', {
  "org_id": "253587"
});

Response shape

Always returns: found, source, data_as_of

FieldTypeDescription
file_numberstringOrganization id in the West Virginia register
namestringOrganisation name
entity_typestring | nullEntity type label, null for an unrecognised code
entity_type_codestringThe register’s type code, e.g. C, LLC, PLC
localestring | nulldomestic (formed in West Virginia) or foreign
name_kindstringcurrent = a real organisation; the others are not companies
statusstringTermination reason, or a note that none is recorded
status_normalizedstringactive when no termination is recorded
profit_classstring | nullProfit or Non-Profit
effective_datestring | nullISO date
established_datestring | nullISO date
termination_datestring | nullISO date
termination_reasonstring | nullWhy the organisation was terminated
foundbooleanFalse only when the register answered and holds no such id
org_idstringThe id asked, when not found
empty_reasonstringno_such_entity when not found
business_purposestring | nullIndustry code and text
charter_countystring | nullCharter county
charter_statestring | nullCharter state
control_numberstring | nullControl number
sourcestringPublisher and dataset
data_as_ofstringDate of the live read
status_basisstringAlways inferred: the register has no status column, so status_normalized comes from whether a termination is recorded.
Full JSON Schema
{
  "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"
    },
    "found": {
      "type": "boolean",
      "description": "False only when the register answered and holds no such id"
    },
    "org_id": {
      "type": "string",
      "description": "The id asked, when not found"
    },
    "empty_reason": {
      "type": "string",
      "description": "no_such_entity when not found"
    },
    "business_purpose": {
      "type": [
        "string",
        "null"
      ],
      "description": "Industry code and text"
    },
    "charter_county": {
      "type": [
        "string",
        "null"
      ],
      "description": "Charter county"
    },
    "charter_state": {
      "type": [
        "string",
        "null"
      ],
      "description": "Charter state"
    },
    "control_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "Control number"
    },
    "source": {
      "type": "string",
      "description": "Publisher and dataset"
    },
    "data_as_of": {
      "type": "string",
      "description": "Date of the live read"
    },
    "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."
    }
  },
  "required": [
    "found",
    "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