GET https://api.cobaltintelligence.com/v1/search?name={encoded_name}&state={state_code} with Authorization: Bearer YOUR_TOKEN
Parse response.results[] for each matching entity; each result includes entity_name, entity_type, status, formation_date, registered_agent, and entity_id (the state-assigned number)
To retrieve officer information (available in 28 states as of 2025), call GET https://api.cobaltintelligence.com/v1/entity/{state_code}/{entity_id}/officers
Use the entity_id from step 2 to call GET /v1/entity/{state_code}/{entity_id} for the full entity profile including filing history
For multi-state searches, loop over required state codes; each lookup costs 1 credit against your account balance
Store entity_id and state_code together as the composite key; entity IDs are only unique within a state
Known gotchas
Cobalt pulls directly from each SOS website in real time, so response latency is variable (typically seconds but can be longer during SOS maintenance windows)
Officer information is only available in 28 states; for unsupported states the officers endpoint returns empty results without an error — check the jurisdiction coverage documentation before building business logic that depends on officers
The credit-based billing model means unexpected high-volume loops can exhaust credits quickly; implement request throttling and pre-check credit balance via GET /v1/account
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp