{"openapi":"3.0.3","info":{"title":"Gnist Context — OpenCorporates","description":"Global company search — incorporation data, officers, and filings across jurisdictions.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/opencorporates/`\n- **Toolkit page:** `/toolkits/opencorporates`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/opencorporates/search_company":{"post":{"tags":["Legal"],"summary":"search_company","description":"Search the global company registry by name.\n\nCovers 200+ jurisdictions via the OpenCorporates database.\n\nArgs:\n    name: Company name or partial name to search for (e.g. \"Apple\", \"Acme Corp\").\n    jurisdiction: OpenCorporates jurisdiction code (e.g. \"gb\" for UK, \"us_de\" for Delaware,\n                  \"no\" for Norway, \"de\" for Germany). Omit for global search.\n    status: Filter by company status: \"Active\", \"Dissolved\", \"Inactive\". Omit for all.\n    max_results: Number of results to return (1–100, default 20).\n\nReturns:\n    Dictionary with count and list of matching companies (registry_id, name, jurisdiction,\n    status, incorporation_date, company_type, address). Use registry_id for details.","operationId":"opencorporates_search_company","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"name":{"description":"Company name or partial name to search for (e.g. \"Apple\", \"Acme Corp\").","type":"string"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"OpenCorporates jurisdiction code (e.g. \"gb\" for UK, \"us_de\" for Delaware, \"no\" for Norway, \"de\" for Germany). Omit for global search."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by company status: \"Active\", \"Dissolved\", \"Inactive\". Omit for all."},"max_results":{"default":20,"description":"Number of results to return (1–100, default 20).","type":"integer"}},"required":["name"],"type":"object"}}}}}},"/rest/opencorporates/get_company_details":{"post":{"tags":["Legal"],"summary":"get_company_details","description":"Get full details for a specific company.\n\nReturns comprehensive information including registered address, industry codes,\nincorporation and dissolution dates, and company type.\n\nArgs:\n    registry_id: Company identifier in the format \"{jurisdiction}/{company_number}\",\n                 e.g. \"gb/12345678\" or \"us_de/1234567\". Obtained from search_company.\n\nReturns:\n    Full company record, or {\"error\": \"not_found\"} if the registry ID is unknown.","operationId":"opencorporates_get_company_details","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"registry_id":{"description":"Company identifier in the format \"{jurisdiction}/{company_number}\", e.g. \"gb/12345678\" or \"us_de/1234567\". Obtained from search_company.","type":"string"}},"required":["registry_id"],"type":"object"}}}}}},"/rest/opencorporates/list_officers":{"post":{"tags":["Legal"],"summary":"list_officers","description":"List directors and officers of a company.\n\nReturns all registered officers including directors, secretaries, and other\nroles where this information is publicly available.\n\nArgs:\n    registry_id: Company identifier in the format \"{jurisdiction}/{company_number}\",\n                 e.g. \"gb/12345678\". Obtained from search_company.\n\nReturns:\n    Dictionary with count and list of officers (name, role, start_date, end_date,\n    nationality, occupation, inactive flag).","operationId":"opencorporates_list_officers","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"registry_id":{"description":"Company identifier in the format \"{jurisdiction}/{company_number}\", e.g. \"gb/12345678\". Obtained from search_company.","type":"string"}},"required":["registry_id"],"type":"object"}}}}}},"/rest/opencorporates/check_company_status":{"post":{"tags":["Legal"],"summary":"check_company_status","description":"Quick status check for a company by name.\n\nReturns the top matching company and its current status (active, dissolved, etc.).\nUseful for KYC pre-checks and supplier verification.\n\nArgs:\n    name: Company name to check (exact or near-exact match works best).\n    jurisdiction: OpenCorporates jurisdiction code (e.g. \"gb\", \"us_de\", \"no\").\n                  Strongly recommended to reduce ambiguity.\n\nReturns:\n    Object with the best match company name, status, registry_id, and jurisdiction.\n    Returns {\"error\": \"not_found\"} if no matches are found.","operationId":"opencorporates_check_company_status","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"name":{"description":"Company name to check (exact or near-exact match works best).","type":"string"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"OpenCorporates jurisdiction code (e.g. \"gb\", \"us_de\", \"no\"). Strongly recommended to reduce ambiguity."}},"required":["name"],"type":"object"}}}}}},"/rest/opencorporates/report_feedback":{"post":{"tags":["Legal"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"opencorporates_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Legal","description":"Data sources: Legal"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}