Skip to navigation
Build with AI

MCP server

Let Claude, Cursor or any MCP client search these docs from inside your editor.

The Model Context Protocol (MCP) lets an AI client such as Claude or Cursor connect to a server and call its tools. This documentation site serves one, so your agent can look things up in the Toden docs without you pasting pages into the chat.

Status
Documentation MCP server (search these docs)Available at /_mcp/server on this site
Account MCP server (create sessions, read results)Planned. Not available yet.

What the documentation server does

It has one tool, searchDocs: the agent sends a question and gets back the matching passages with links to their pages.

It doesIt does not
Search the guides and the API referenceRead your account, customers or verifications
Return passages and page links for the agent to work fromCreate sessions, run checks or change settings
Stay current with the published docsTake or need a Toden API key

It gives an agent the same public pages you can read here, and nothing else.

Connect your client

The server address is this site’s address followed by /_mcp/server.

claude mcp add --transport http toden-docs https://docs.toden.co/_mcp/server

Then run /mcp inside Claude Code to check the connection.

Once connected, ask in plain language, for example “How do I verify a Toden webhook signature?”, and the agent looks the answer up in these docs.

For building an integration, pair the server with the integration prompt. The prompt tells the agent what to ask you and which rules to follow; the server lets it check each detail against the docs.

Without MCP

Everything the server searches is also available in forms an agent can read directly.

llms.txt and Markdown pages

An index of every page, and each page as Markdown by adding .md to its address.

OpenAPI contracts

The exact request and response shapes for both API families.

Integration prompt

A prompt to paste into your agent, with the rules that are easy to get wrong.

Agent skills

One short brief per product to save in your agent’s skills folder.

Is there an MCP server I can run myself?

Not as a product. Toden’s own engineers use a small local MCP server while working on the platform. It runs on a developer’s machine from the Toden source code, serves integration documentation only, and makes no API calls. It is not published as a package and is not available to customers.

You do not need it. The same material is public through llms.txt, the Markdown pages and the OpenAPI contracts above.

An MCP server that works with your account

An MCP server that performs actions, such as creating a verification session or reading a result, is planned and not available yet. We will announce it here and in the changelog.

To let an agent work with the API today, have it write ordinary code against the REST API using the OpenAPI contracts, and run that code in Sandbox with a test key. Keep these rules:

  • Never paste a secret key (sk_...) into a prompt or a chat. Read keys from environment variables.
  • Build and test in Sandbox. A person should approve anything that affects real customers.
  • A failed or timed-out call is never an approval.

The full list is in Integrate with an AI agent.