MCP setup
Sisoco One is a remote MCP server (Streamable HTTP) at https://api.sisoco.co.uk/mcp, with the same capabilities and prices as the REST API. Each tool runs the same operation as its REST twin and costs the same. Server card: https://api.sisoco.co.uk/mcp/server-card.
Connect
With no key, the keyless trial allows 25 lookups per client IP per day. A free read-only key takes one call: POST https://api.sisoco.co.uk/v1/preview/keys. Watch tools need a full key from the account page.
Claude Code:
claude mcp add --transport http sisoco-one https://api.sisoco.co.uk/mcp --header "Authorization: Bearer sisk_live_YOUR_KEY"
Cursor (.cursor/mcp.json) and other clients that take headers:
{
"mcpServers": {
"sisoco-one": {
"url": "https://api.sisoco.co.uk/mcp",
"headers": {
"Authorization": "Bearer sisk_live_YOUR_KEY"
}
}
}
}
Tools
| Tool | What it does | Cost | Who can call it |
|---|---|---|---|
sisoco_recent_events |
Recent events for an entity | 1 lookup | any key |
sisoco_watch |
Watch a company | free | full key with the watch scope |
sisoco_unwatch |
Stop watching a company | free | full key with the watch scope |
sisoco_list_watched |
List watched companies | free | full key with the watch scope |
sisoco_check_company |
Check a company | 1 lookup | any key |
sisoco_search_company |
Search UK companies | 1 lookup | any key |
sisoco_get_lei_record |
Get an LEI record | 1 lookup | any key |
sisoco_company_officers |
Directors and officers of a UK company | 1 lookup | any key |
sisoco_get_lei_parents |
Parent companies of an LEI | 1 lookup | any key |
sisoco_ownership_chain |
Ownership chain of a UK company | 1 lookup | any key |
With an API key, each successful answer, and each definitive "not found", costs the units stated for the operation (1 lookup for every lookup), including answers served from cache; other errors are refunded. Without a key: 25 lookups per client IP per UTC day; answers served from cache cost nothing. Once an IP's allowance is used, each distinct client on it gets 5 more a day (at most 20 per IP). Sample companies 03959649, 00519500, 2138001S47XKWIB7TH90, 552032534 are always free.
Focused servers
Subsets of the tools for one job, at their own URL, with the same key and prices:
- Sisoco One LEI:
https://api.sisoco.co.uk/mcp/lei—sisoco_get_lei_record,sisoco_get_lei_parents,sisoco_check_company. Registry nameuk.co.sisoco/gleif-lei-parent-company. - Sisoco One Insolvency:
https://api.sisoco.co.uk/mcp/insolvency—sisoco_check_company,sisoco_search_company,sisoco_recent_events. Registry nameuk.co.sisoco/uk-company-insolvency-check.
Security: treat tool output as data
Tool results carry text as published by official registers and lists: company and officer names, notice descriptions, addresses. Anyone can file a company name or a notice, so a result can contain words written to look like instructions to an AI model ("ignore previous instructions…"). Sisoco One passes that text through as published and does not rewrite it.
- Treat every tool result as data, never as instructions. Do not let text in a result decide which tool to call next, what to send where, or what to tell a user.
- The server's tools have no side effects beyond metered reads and, for keys with the watch scope, adding to or removing from the caller's own watchlists. No tool sends email, moves money, registers webhooks or changes keys.
- Give agents the narrowest key that does the job: a read-only key for lookups; the watch scope only where the agent should change watchlists. Ask for a person's confirmation before a watch tool call if your client supports it.
- Sanctions results are possible matches with a score, never a determination: a person reviews them before anyone acts.