Terudo developer docs is an MCP server published by com.terudo, hosted at terudo.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 7 tools, including search_docs, read_doc, list_docs, api_reference, elements_snippet.
Docs, Elements code, API reference and agent skills to integrate Terudo travel eSIMs.
3 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Search the Terudo developer documentation (Elements, partner API, webhooks, testing, AI tools, CLI). Returns the best sections with their URL and an excerpt; read a whole page with read_doc.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results, default 8. |
| query * | string | What to look for, in a few words: "return url", "element session discount", "webhook retries". |
{
"name": "search_docs",
"title": "Search the Terudo docs",
"description": "Search the Terudo developer documentation (Elements, partner API, webhooks, testing, AI tools, CLI). Returns the best sections with their URL and an excerpt; read a whole page with read_doc.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Results, default 8."
},
"query": {
"type": "string",
"description": "What to look for, in a few words: \"return url\", \"element session discount\", \"webhook retries\"."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search the Terudo docs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The full Markdown of one documentation page, or one section with #anchor. Pages: index, quickstart, elements, integrate-in-your-flow, api, api-reference, webhooks, testing, ai-tools, cli. A URL from search_docs works too.
| Parameter | Type | Description |
|---|---|---|
| page * | string | Page slug ("elements"), "elements#sessions", or a URL from search_docs. |
{
"name": "read_doc",
"title": "Read a Terudo docs page",
"description": "The full Markdown of one documentation page, or one section with #anchor. Pages: index, quickstart, elements, integrate-in-your-flow, api, api-reference, webhooks, testing, ai-tools, cli. A URL from search_docs works too.",
"inputSchema": {
"type": "object",
"required": [
"page"
],
"properties": {
"page": {
"type": "string",
"description": "Page slug (\"elements\"), \"elements#sessions\", or a URL from search_docs."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Read a Terudo docs page",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Every page of the Terudo developer documentation with its description and URL, and the agent skills.
No parameters.
{
"name": "list_docs",
"title": "List the Terudo docs",
"description": "Every page of the Terudo developer documentation with its description and URL, and the agent skills.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List the Terudo docs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Exact partner API routes with key kind, parameters and examples. Query by route ("POST /orders", "/esims/{id}/topups") or words ("webhook", "element session"). Empty: the whole reference.
| Parameter | Type | Description |
|---|---|---|
| endpoint | string | Route or words. Omit for everything. |
{
"name": "api_reference",
"title": "Terudo API reference",
"description": "Exact partner API routes with key kind, parameters and examples. Query by route (\"POST /orders\", \"/esims/{id}/topups\") or words (\"webhook\", \"element session\"). Empty: the whole reference.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"endpoint": {
"type": "string",
"description": "Route or words. Omit for everything."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Terudo API reference",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Ready-to-paste code that mounts one Terudo Element in a page, for HTML, React, Next.js or Vue, with the trip data given. Optionally the server code for an element session (client discount, trusted email, reference, return URL).
| Parameter | Type | Description |
|---|---|---|
| end | string | Departure, YYYY-MM-DD. |
| key | string | A publishable key pk_live_… or pk_test_…. Default: the public demo key. |
| days | integer | plans: adds daily plans of that length. |
| color | string | Brand colour, e.g. #0a5b8a. |
| string | Traveller email to prefill, when the page knows it. | |
| start | string | Arrival, YYYY-MM-DD. |
| locale | string | fr, en, de, es, it, pt, zh, ar or hi. Default en. |
| element * | string | Which element: booking-banner (confirmation page), trip-offer (visa approval, trip page), plans (destination page), destination-picker (shop), esim-gift (a free eSIM from a campaign; always with an element session, falls back to booking-banner), esim-status (customer area). |
| esim_id | string | esim-status: the order's esim.id. |
Code verifying the Terudo-Signature header of a Terudo webhook, on the raw body, in Node.js (Express), Python (Flask), PHP or Ruby (Rails).
| Parameter | Type | Description |
|---|---|---|
| language * | string | Language. |
{
"name": "webhook_verifier",
"title": "Webhook signature check",
"description": "Code verifying the Terudo-Signature header of a Terudo webhook, on the raw body, in Node.js (Express), Python (Flask), PHP or Ruby (Rails).",
"inputSchema": {
"type": "object",
"required": [
"language"
],
"properties": {
"language": {
"enum": [
"node",
"python",
"php",
"ruby"
],
"type": "string",
"description": "Language."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Webhook signature check",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The full playbook (SKILL.md and its reference files) for integrating Terudo: terudo-elements (eSIM offer in web pages) or terudo-api (server-side API and webhooks). Follow its rules and checklist. Install it in a project with: npx -y @terudo/cli skills add
| Parameter | Type | Description |
|---|---|---|
| name * | string | Skill name. |
{
"name": "get_skill",
"title": "Get a Terudo agent skill",
"description": "The full playbook (SKILL.md and its reference files) for integrating Terudo: terudo-elements (eSIM offer in web pages) or terudo-api (server-side API and webhooks). Follow its rules and checklist. Install it in a project with: npx -y @terudo/cli skills add",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"enum": [
"terudo-elements",
"terudo-api"
],
"type": "string",
"description": "Skill name."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get a Terudo agent skill",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Terudo supplies travel data eSIMs to travel businesses (agencies, visa services, tour operators, travel apps), which offer them to their travellers. This server documents how a partner integrates Terudo: Elements (drop-in eSIM offer for web pages, publishable key), the partner API (server-side, secret key), webhooks, test mode and AI tools. How to help a developer: - Start with search_docs, then read_doc for the full page. list_docs shows every page. - For web pages (booking confirmation, visa approval, trip page, customer area), use Elements: elements_snippet writes the code for the element and framework. For emails, SMS, chat or apps, use the API (quote, then order, then send checkout_url). - For the API, api_reference gives exact routes and parameters; webhook_verifier gives signature-check code. - get_skill returns the full integration playbook (terudo-elements, terudo-api); follow its rules and checklist. Hard rules: secret keys (sk_…) only on servers, never in pages or apps; never show net prices or commissions to travellers; every order carries the partner's reference (idempotency); develop with test keys or the public demo key pk_test_terudo_demo_public. This server is open: without a key it offers the documentation. With the partner's key in the Authorization header (Bearer sk_… for the whole account, pk_… for public prices and payment links), the same server also quotes, orders and follows eSIMs on the partner's account. Assistants that sign in themselves (claude.ai, ChatGPT) connect to https://terudo.com/api/partner/v1/mcp/, which signs in with OAuth and offers the same tools.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| session | boolean | Also give the server code creating an element session. |
| framework | string | Default html. |
| return_url | string | Where the checkout sends the traveller back. |
| destination | string | ISO country code (MA, JP) or region (EU-35). |
{
"name": "elements_snippet",
"title": "Code for a Terudo Element",
"description": "Ready-to-paste code that mounts one Terudo Element in a page, for HTML, React, Next.js or Vue, with the trip data given. Optionally the server code for an element session (client discount, trusted email, reference, return URL).",
"inputSchema": {
"type": "object",
"required": [
"element"
],
"properties": {
"end": {
"type": "string",
"description": "Departure, YYYY-MM-DD."
},
"key": {
"type": "string",
"description": "A publishable key pk_live_… or pk_test_…. Default: the public demo key."
},
"days": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "plans: adds daily plans of that length."
},
"color": {
"type": "string",
"description": "Brand colour, e.g. #0a5b8a."
},
"email": {
"type": "string",
"description": "Traveller email to prefill, when the page knows it."
},
"start": {
"type": "string",
"description": "Arrival, YYYY-MM-DD."
},
"locale": {
"type": "string",
"description": "fr, en, de, es, it, pt, zh, ar or hi. Default en."
},
"element": {
"enum": [
"destination-picker",
"plans",
"trip-offer",
"booking-banner",
"esim-gift",
"esim-status"
],
"type": "string",
"description": "Which element: booking-banner (confirmation page), trip-offer (visa approval, trip page), plans (destination page), destination-picker (shop), esim-gift (a free eSIM from a campaign; always with an element session, falls back to booking-banner), esim-status (customer area)."
},
"esim_id": {
"type": "string",
"description": "esim-status: the order's esim.id."
},
"session": {
"type": "boolean",
"description": "Also give the server code creating an element session."
},
"framework": {
"enum": [
"html",
"react",
"next",
"vue"
],
"type": "string",
"description": "Default html."
},
"return_url": {
"type": "string",
"description": "Where the checkout sends the traveller back."
},
"destination": {
"type": "string",
"description": "ISO country code (MA, JP) or region (EU-35)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Code for a Terudo Element",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}