Query the OpenCorporates API at https://api.opencorporates.com/v0.4/companies/search?q={name}&jurisdiction_code={us_xx} to search by company name within a specific U.S. state jurisdiction; obtain an API token for higher rate limits.
Parse the response's companies array for company_number, jurisdiction_code, registered_address, incorporation_date, company_type, and current_status (active/inactive/dissolved).
For jurisdictions with direct API access (e.g., Delaware Division of Corporations, California Secretary of State), query state-specific search endpoints directly for authoritative real-time data; OpenCorporates data may lag slightly.
Cross-reference entities across multiple jurisdictions using the OpenCorporates company network endpoint to identify parent/subsidiary relationships.
Cache entity lookup results with a TTL appropriate to your use case (e.g., 24 hours for general diligence, real-time for contract signing workflows).
Escalate findings of dissolved, suspended, or administratively revoked entities to a lawyer before executing contracts with them, as contracting with a non-existent legal entity creates enforceability risk.
Known gotchas
OpenCorporates data is aggregated from official sources but is not always current; always verify status on the authoritative Secretary of State portal for high-stakes transactions.
Company name searches return partial matches; always verify the exact legal name and company number before using an entity in a contract, as similarly named entities in the same jurisdiction can cause errors.
Some states charge fees for direct API or bulk data access; OpenCorporates abstracts this but their data update frequency varies by jurisdiction — check the data_updated_at field in the response.
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