§ MCP server

Run a compliance check from your AI assistant.

getsorted runs a free, public MCP (Model Context Protocol) server. Connect it to Claude, Cursor, VS Code or any MCP client and your assistant can check a UK business against our regulation cards, in conversation. No API key, no account, nothing stored.

Endpoint https://api.getsorted.today/mcp

Transport: streamable HTTP · Auth: none · State: none, every call is independent

Tools

Tool	What it does
`get_questions`	The yes/no questions the check is based on, with help text and gating conditions.
`get_startup_checklist`	The ordered steps for starting a UK business, from incorporation through to fixing compliance gaps, each with a description and a link.
`run_compliance_check`	Takes a map of answers (and an optional SIC code) and returns the full report: cards sorted action_needed first, with risk, action and official guidance links.
`list_cards`	Every regulation the checker covers, with severity and a link to its plain-English guide.
`get_card`	Full detail for one regulation: risk, required action, and the exact conditions under which it applies.
`search_companies_house`	Finds a company's exact number from its name, active companies only, capped at eight matches.
`check_director_verification`	Returns a company's Companies House identity verification deadline plus live verification status for its directors and persons with significant control, naming anyone still outstanding.

The last two call the live Companies House register, so they need COMPANIES_HOUSE_API_KEY set on the server. They report identity verification status only, not confirmation statements, accounts, or any other filing obligation. Every other tool answers in-process with no network call.

The server also ships three ready-made prompts, shown in clients with a prompt picker (Claude Desktop, Cursor): check_my_business (describe your business in a sentence, get a full check), explain_regulation (ask about one regulation) and starting_a_business (walk through the steps from incorporation to full compliance).

Authenticated server: your own dashboard, read-only

POST https://api.getsorted.today/mcp/me

Transport: streamable HTTP · Auth: OAuth (sign in to your getsorted account) · Read-only: nothing here writes data

A separate server from the one above, and it stays separate deliberately: the public server needs no account and never will. This one requires signing in to the same account as the dashboard, and only answers questions about companies you're actually a member of.

Tool	What it does
`list_my_companies`	The companies you're a member of, with your role on each.
`get_my_overview`	Open item counts and the next dated deadline, across every company you run.
`get_company_report`	One company's full compliance report, including anything already sorted, snoozed or delegated.
`get_company_timeline`	One company's dated obligations: statutory Companies House dates, open cards, custom reminders.
`get_company_playbook`	One company's Founder Journey picture across all 7 areas of running a business.

To change anything, e.g. add a reminder, mark a card sorted, answer a question, use the dashboard itself. This server can't write.

Add it to your client

Claude Code

claude mcp add --transport http getsorted https://api.getsorted.today/mcp

Then ask: "Use getsorted to check my business. I run a small web agency with two employees."

Claude (web and desktop)

Settings → Connectors → Add custom connector, then paste the endpoint URL above.

Cursor

Add to Cursor

Or add to .cursor/mcp.json using the JSON below.

VS Code

code --add-mcp '{"name":"getsorted","type":"http","url":"https://api.getsorted.today/mcp"}'

Any other MCP client

{
  "mcpServers": {
    "getsorted": {
      "url": "https://api.getsorted.today/mcp"
    }
  }
}

Try it without a client

The MCP Inspector gives you a browser UI to poke at the tools:

npx @modelcontextprotocol/inspector

Connect with transport Streamable HTTP and the endpoint URL above. Or verify the server is up with curl:

curl -s -X POST https://api.getsorted.today/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

What you get back

The same engine that powers the checker: each regulation card comes back with a status (action needed, worth checking, looks good, not applicable), a plain-English summary, what is at stake, what to do, and a link to official guidance. Reports over MCP carry no partner links.

Everything is guidance based on ICO, GOV.UK and other authoritative sources, not legal advice. Answers are processed per request and never stored.

llms.txt REST API for partners