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개