Docs, Elements code, API reference and agent skills to integrate Terudo travel eSIMs.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Route or words. Omit for everything.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http docs https://terudo.com/mcp/
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.
| Argument | Type | Description |
|---|---|---|
| endpoint | string | Route or words. Omit for everything. |
{
"type": "object",
"required": [],
"properties": {
"endpoint": {
"type": "string",
"description": "Route or words. Omit for everything."
}
},
"additionalProperties": 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).
| Argument | 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-status (customer area). |
| esim_id | string | esim-status: the order's esim.id. |
| 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 |
{
"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-status"
],
"type": "string",
"description": "Which element: booking-banner (confirmation page), trip-offer (visa approval, trip page), plans (destination page), destination-picker (shop), 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
}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
| Argument | Type | Description |
|---|---|---|
| name* | string | Skill name. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"enum": [
"terudo-elements",
"terudo-api"
],
"type": "string",
"description": "Skill name."
}
},
"additionalProperties": false
}Every page of the Terudo developer documentation with its description and URL, and the agent skills.
No arguments.
{
"type": "object",
"required": [],
"properties": {},
"additionalProperties": 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.
| Argument | Type | Description |
|---|---|---|
| page* | string | Page slug ("elements"), "elements#sessions", or a URL from search_docs. |
{
"type": "object",
"required": [
"page"
],
"properties": {
"page": {
"type": "string",
"description": "Page slug (\"elements\"), \"elements#sessions\", or a URL from search_docs."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Results, default 8. |
| query* | string | What to look for, in a few words: "return url", "element session discount", "webhook retries". |
{
"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
}Code verifying the Terudo-Signature header of a Terudo webhook, on the raw body, in Node.js (Express), Python (Flask), PHP or Ruby (Rails).
| Argument | Type | Description |
|---|---|---|
| language* | string | Language. |
{
"type": "object",
"required": [
"language"
],
"properties": {
"language": {
"enum": [
"node",
"python",
"php",
"ruby"
],
"type": "string",
"description": "Language."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 13, 2026.
| string |
| ISO country code (MA, JP) or region (EU-35). |