nd_search_businesses
Pack: nd-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/nd_search_businesses for the schema, then POST the same URL with its arguments for the data.
Search the North Dakota Secretary of State business records by entity name.
Tool description as the model sees it
Search the North Dakota Secretary of State business records (FirstStop) by the start of an entity’s name. Returns each entity’s file_number (its SOS control 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. Trade names are included and show their type. Entity-level only: no individuals’ names, no agents, no addresses (the register’s search does not carry them). Includes inactive entities unless active_only is true.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
name | string | yes | Start of the entity name, e.g. “Bobcat”. |
active_only | boolean | no | Only entities in an active status. Default false. |
limit | number | no | Maximum rows (1-100, default 25). |
Example call
Arguments
{
"name": "Acme Farms, Inc.",
"limit": 3
}
curl
curl -X POST https://gateway.pipeworx.io/nd-sos-business/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nd_search_businesses","arguments":{"name":"Acme Farms, Inc.","limit":3}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('nd_search_businesses', {
"name": "Acme Farms, Inc.",
"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": {
"control_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 nd-sos-business pack
{
"mcpServers": {
"nd-sos-business": {
"url": "https://gateway.pipeworx.io/nd-sos-business/mcp"
}
}
}
See Getting Started for client-specific install steps.