Legal
Data source: OpenCorporates
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/opencorporates/
claude_desktop_config.json
{
"mcpServers": {
"gnist-opencorporates": {
"url": "https://context.gnist.ai/mcp/opencorporates/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/opencorporates/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_company", "arguments": {"name": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/opencorporates/
5 endpoints available:
GET /rest/opencorporates/search_companyGET /rest/opencorporates/get_company_detailsGET /rest/opencorporates/list_officersGET /rest/opencorporates/check_company_statusGET /rest/opencorporates/report_feedback
Shell
curl "https://context.gnist.ai/rest/opencorporates/search_company?name=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/opencorporates/search_company",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"name": "example"
},
)
print(resp.json())
Command Line
Command
gc opencorporates
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (5)
search_companySearch the global company registry by name.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | required | Company name or partial name to search for (e.g. "Apple", "Acme Corp"). |
jurisdiction | any | optional | OpenCorporates jurisdiction code (e.g. "gb" for UK, "us_de" for Delaware, "no" for Norway, "de" for Germany). Omit for global search. |
status | any | optional | Filter by company status: "Active", "Dissolved", "Inactive". Omit for all. |
max_results | integer | optional | Number of results to return (1–100, default 20). (default: 20) |
get_company_detailsGet full details for a specific company.
| Parameter | Type | Required | Description |
|---|---|---|---|
registry_id | string | required | Company identifier in the format "{jurisdiction}/{company_number}", e.g. "gb/12345678" or "us_de/1234567". Obtained from search_company. |
list_officersList directors and officers of a company.
| Parameter | Type | Required | Description |
|---|---|---|---|
registry_id | string | required | Company identifier in the format "{jurisdiction}/{company_number}", e.g. "gb/12345678". Obtained from search_company. |
check_company_statusQuick status check for a company by name.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | required | Company name to check (exact or near-exact match works best). |
jurisdiction | any | optional | OpenCorporates jurisdiction code (e.g. "gb", "us_de", "no"). Strongly recommended to reduce ambiguity. |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |