Server definition
- Hash
- sha256:2eade007fb64f75c9c7ecb99bae1e2c0018d8fd6bfc1e123799bdf73449d82d2
- What it is
- What a remote MCP server returned when asked what it offers: 7 tools
The blob, as servednamed by its sha256
{
"instructions": "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.\n\nHow to help a developer:\n- Start with search_docs, then read_doc for the full page. list_docs shows every page.\n- 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).\n- For the API, api_reference gives exact routes and parameters; webhook_verifier gives signature-check code.\n- get_skill returns the full integration playbook (terudo-elements, terudo-api); follow its rules and checklist.\nHard 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.\nTo act on a partner's account (quotes, orders, eSIMs) an assistant uses the partner MCP server https://terudo.com/api/partner/v1/mcp/ with the partner's key, not this one.",
"tools": [
{
"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": {
"additionalProperties": false,
"properties": {
"endpoint": {
"description": "Route or words. Omit for everything.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "api_reference",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"color": {
"description": "Brand colour, e.g. #0a5b8a.",
"type": "string"
},
"days": {
"description": "plans: adds daily plans of that length.",
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"destination": {
"description": "ISO country code (MA, JP) or region (EU-35).",
"type": "string"
},
"element": {
"description": "Which element: booking-banner (confirmation page), trip-offer (visa approval, trip page), plans (destination page), destination-picker (shop), esim-status (customer area).",
"enum": [
"destination-picker",
"plans",
"trip-offer",
"booking-banner",
"esim-status"
],
"type": "string"
},
"email": {
"description": "Traveller email to prefill, when the page knows it.",
"type": "string"
},
"end": {
"description": "Departure, YYYY-MM-DD.",
"type": "string"
},
"esim_id": {
"description": "esim-status: the order's esim.id.",
"type": "string"
},
"framework": {
"description": "Default html.",
"enum": [
"html",
"react",
"next",
"vue"
],
"type": "string"
},
"key": {
"description": "A publishable key pk_live_… or pk_test_…. Default: the public demo key.",
"type": "string"
},
"locale": {
"description": "fr, en, de, es, it, pt, zh, ar or hi. Default en.",
"type": "string"
},
"return_url": {
"description": "Where the checkout sends the traveller back.",
"type": "string"
},
"session": {
"description": "Also give the server code creating an element session.",
"type": "boolean"
},
"start": {
"description": "Arrival, YYYY-MM-DD.",
"type": "string"
}
},
"required": [
"element"
],
"type": "object"
},
"name": "elements_snippet",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"name": {
"description": "Skill name.",
"enum": [
"terudo-elements",
"terudo-api"
],
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "get_skill",
"outputSchema": null
},
{
"description": "Every page of the Terudo developer documentation with its description and URL, and the agent skills.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"required": [],
"type": "object"
},
"name": "list_docs",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"page": {
"description": "Page slug (\"elements\"), \"elements#sessions\", or a URL from search_docs.",
"type": "string"
}
},
"required": [
"page"
],
"type": "object"
},
"name": "read_doc",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Results, default 8.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "What to look for, in a few words: \"return url\", \"element session discount\", \"webhook retries\".",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_docs",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"language": {
"description": "Language.",
"enum": [
"node",
"python",
"php",
"ruby"
],
"type": "string"
}
},
"required": [
"language"
],
"type": "object"
},
"name": "webhook_verifier",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:2eade007fb64f75c9c7ecb99bae1e2c0018d8fd6bfc1e123799bdf73449d82d2 | sha256sum