ky_search_businesses

Pack: ky-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/ky_search_businesses for the schema, then POST the same URL with its arguments for the data.

Search the Kentucky Secretary of State business entity register by name.

Tool description as the model sees it

Search the Kentucky Secretary of State Business Entity Search by entity name. Returns each entity’s file_number (its organization number), name, status (e.g. A - Active, I - Inactive) and company type. Tolerant of case, punctuation, ”&” vs “and” and the legal-form spelling (Inc / Incorporated, LLC / L.L.C.): 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. The register returns at most 50 rows a page and this tool reads the first page; total_in_register says how many the register counted. Entity-level only: no individuals’ names (registered agents and officers are not returned). Pass a row’s file_number as org_number to ky_get_business for detail.

Parameters

NameTypeRequiredDescription
namestringyesEntity name or the start of it, e.g. “Brown-Forman”.
active_onlybooleannoOnly active entities. Default false (all statuses).
limitnumbernoMaximum rows (1-50, default 25).

Example call

Arguments

{
  "name": "Acme, LLC",
  "limit": 3
}

curl

curl -X POST https://gateway.pipeworx.io/ky-sos-business/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ky_search_businesses","arguments":{"name":"Acme, LLC","limit":3}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('ky_search_businesses', {
  "name": "Acme, LLC",
  "limit": 3
});

Response shape

FieldTypeDescription
querystring
hitsnumber
total_in_registernumber
total_returnednumber
resultsarray
sourcestring
data_as_ofstring
Full JSON Schema
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "hits": {
      "type": "number"
    },
    "total_in_register": {
      "type": "number"
    },
    "total_returned": {
      "type": "number"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "org_number": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "company_type": {
            "type": "string"
          },
          "match": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "source": {
      "type": "string"
    },
    "data_as_of": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

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 ky-sos-business pack
{
  "mcpServers": {
    "ky-sos-business": {
      "url": "https://gateway.pipeworx.io/ky-sos-business/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 17, 2026