id_search_businesses
Pack: id-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/id_search_businesses for the schema, then POST the same URL with its arguments for the data.
Search the Idaho Secretary of State business register by entity name.
Tool description as the model sees it
Search the Idaho Secretary of State business-entity register by the start of an entity’s name. Returns each entity’s file_number (its entity number), name, entity type, status, standing and filing date. 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. Entity-level only: no individuals’ names (registered agents are not returned). Includes inactive entities unless active_only is true. Pass a row’s file_number as entity_number to id_get_business for detail.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
name | string | yes | Start of the entity name, e.g. “Albertsons”. |
active_only | boolean | no | Only entities in an active status. Default false (all statuses). |
limit | number | no | Maximum rows (1-100, default 25). |
Example call
Arguments
{
"name": "Acme",
"limit": 3
}
curl
curl -X POST https://gateway.pipeworx.io/id-sos-business/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"id_search_businesses","arguments":{"name":"Acme","limit":3}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('id_search_businesses', {
"name": "Acme",
"limit": 3
});
Response shape
| Field | Type | Description |
|---|---|---|
query | string | |
hits | number | |
total_returned | number | |
results | array | |
source | string | |
data_as_of | string |
Full JSON Schema
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"hits": {
"type": "number"
},
"total_returned": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"entity_number": {
"type": "string"
},
"name": {
"type": "string"
},
"entity_type": {
"type": "string"
},
"status": {
"type": "string"
},
"standing": {
"type": "string"
},
"filing_date": {
"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 id-sos-business pack
{
"mcpServers": {
"id-sos-business": {
"url": "https://gateway.pipeworx.io/id-sos-business/mcp"
}
}
}
See Getting Started for client-specific install steps.