ia_search_businesses
Pack: ia-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/ia_search_businesses for the schema, then POST the same URL with its arguments for the data.
Search active Iowa business entities by name (Iowa Secretary of State).
Tool description as the model sees it
Search the Iowa Secretary of State register of active business entities by the start of an entity’s name. Returns each entity’s
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
name | string | yes | Start of the entity name, e.g. “Hy-Vee”. |
entity_type | string | no | Optional filter on the entity type text, e.g. “limited liability company”, “non-profit”, “foreign profit”. |
limit | number | no | Maximum rows (1-100, default 25). |
Example call
Arguments
{
"name": "Hy-Vee",
"limit": 3
}
curl
curl -X POST https://gateway.pipeworx.io/ia-sos-business/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ia_search_businesses","arguments":{"name":"Hy-Vee","limit":3}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('ia_search_businesses', {
"name": "Hy-Vee",
"limit": 3
});
Response shape
| Field | Type | Description |
|---|---|---|
query | string | |
hits | number | |
total_returned | number | |
results | array | |
source | string | |
data_as_of | string | |
attribution | string | |
coverage | string |
Full JSON Schema
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"hits": {
"type": "number"
},
"total_returned": {
"type": "number"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"file_number": {
"type": "string"
},
"corp_number": {
"type": "string"
},
"name": {
"type": "string"
},
"entity_type": {
"type": "string"
},
"entity_type_code": {
"type": "string"
},
"locale": {
"type": "string"
},
"status": {
"type": "string"
},
"status_normalized": {
"type": "string"
},
"effective_date": {
"type": "string"
},
"address": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"zip": {
"type": "string"
}
},
"additionalProperties": true
},
"match": {
"type": "string"
}
},
"additionalProperties": true
}
},
"source": {
"type": "string"
},
"data_as_of": {
"type": "string"
},
"attribution": {
"type": "string"
},
"coverage": {
"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 ia-sos-business pack
{
"mcpServers": {
"ia-sos-business": {
"url": "https://gateway.pipeworx.io/ia-sos-business/mcp"
}
}
}
See Getting Started for client-specific install steps.