Terudo developer docs

Docs, Elements code, API reference and agent skills to integrate Terudo travel eSIMs.

使うべきか

品質と安全性

A
説明の品質
96%
スキーマの完全性
89%
命名の品質
91%
ポイズニングのリスク
100%
権限の一致
90%
プロトコルへの準拠
100%

検出事項(2)

  • LOWTool 'list_docs' description lacks action verblist_docs 内
  • LOWTool 'webhook_verifier' suggests web access but openWorldHint=falsewebhook_verifier 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~1,291トークン数(ツール定義)
~1.1 KB一般的なレスポンスサイズ
注意への影響は中程度(128k コンテキストの 1.01%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "docs": {
      "url": "https://terudo.com/mcp/"
    }
  }
}

リモートエンドポイント

https://terudo.com/mcp/streamable-http

できること

ツール一覧

ツール(7)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢search_docs(query, limit)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to look for, in a few words: \"return url\", \"element session discount\", \"webhook retries\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Results, default 8."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}
🟢read_doc(page)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "page": {
      "type": "string",
      "description": "Page slug (\"elements\"), \"elements#sessions\", or a URL from search_docs."
    }
  },
  "required": [
    "page"
  ],
  "additionalProperties": false
}
🟢list_docs

Every page of the Terudo developer documentation with its description and URL, and the agent skills.

入力スキーマ

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}
🟢api_reference(endpoint)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "endpoint": {
      "type": "string",
      "description": "Route or words. Omit for everything."
    }
  },
  "required": [],
  "additionalProperties": false
}
🟢elements_snippet(element, framework, destination, start, end, ...)

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).

入力スキーマ

{
  "type": "object",
  "properties": {
    "element": {
      "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).",
      "enum": [
        "destination-picker",
        "plans",
        "trip-offer",
        "booking-banner",
        "esim-gift",
        "esim-status"
      ]
    },
    "framework": {
      "type": "string",
      "description": "Default html.",
      "enum": [
        "html",
        "react",
        "next",
        "vue"
      ]
    },
    "destination": {
      "type": "string",
      "description": "ISO country code (MA, JP) or region (EU-35)."
    },
    "start": {
      "type": "string",
      "description": "Arrival, YYYY-MM-DD."
    },
    "end": {
      "type": "string",
      "description": "Departure, YYYY-MM-DD."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "plans: adds daily plans of that length."
    },
    "esim_id": {
      "type": "string",
      "description": "esim-status: the order's esim.id."
    },
    "key": {
      "type": "string",
      "description": "A publishable key pk_live_… or pk_test_…. Default: the public demo key."
    },
    "locale": {
      "type": "string",
      "description": "fr, en, de, es, it, pt, zh, ar or hi. Default en."
    },
    "color": {
      "type": "string",
      "description": "Brand colour, e.g. #0a5b8a."
    },
    "email": {
      "type": "string",
      "description": "Traveller email to prefill, when the page knows it."
    },
    "return_url": {
      "type": "string",
      "description": "Where the checkout sends the traveller back."
    },
    "session": {
      "type": "boolean",
      "description": "Also give the server code creating an element session."
    }
  },
  "required": [
    "element"
  ],
  "additionalProperties": false
}
🟢webhook_verifier(language)

Code verifying the Terudo-Signature header of a Terudo webhook, on the raw body, in Node.js (Express), Python (Flask), PHP or Ruby (Rails).

入力スキーマ

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "description": "Language.",
      "enum": [
        "node",
        "python",
        "php",
        "ruby"
      ]
    }
  },
  "required": [
    "language"
  ],
  "additionalProperties": false
}
🟢get_skill(name)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Skill name.",
      "enum": [
        "terudo-elements",
        "terudo-api"
      ]
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 7 件