Terudo developer docs
Docs, Elements code, API reference and agent skills to integrate Terudo travel eSIMs.
사용해야 할까요
품질 및 안전성
발견 사항 (2)
- LOWlist_docs에서
- LOWwebhook_verifier에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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
}커뮤니티
증거