---
title: AI tools
description: Build with AI on Terudo. The open docs MCP server, the partner MCP server with your keys, agent skills for Claude Code, Codex, Cursor and others, the CLI, llms.txt and Markdown docs.
---

# AI tools

Everything a coding agent or an AI assistant needs to integrate or sell Terudo eSIMs.

## Docs MCP server (open, no key)

`https://terudo.com/mcp/`, Streamable HTTP, no authentication. For coding agents that integrate Terudo: it searches and reads this documentation, writes Elements snippets for your page and framework, gives webhook verification code and serves the agent skills.

Tools: `search_docs`, `read_doc`, `list_docs`, `api_reference`, `elements_snippet`, `webhook_verifier`, `get_skill`. Every docs page is also a resource, and each skill a prompt.

**Claude Code**

```bash
claude mcp add --transport http terudo-docs https://terudo.com/mcp/
```

**Cursor** (`.cursor/mcp.json`), **Windsurf**, **Claude Desktop** and most clients:

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

**VS Code** (`.vscode/mcp.json`):

```json
{ "servers": { "terudo-docs": { "type": "http", "url": "https://terudo.com/mcp/" } } }
```

**Codex CLI** (`~/.codex/config.toml`):

```toml
[mcp_servers.terudo-docs]
url = "https://terudo.com/mcp/"
```

Or let the CLI write it: `npx -y @terudo/cli mcp add cursor`.

## Partner MCP server (your keys)

`https://terudo.com/api/partner/v1/mcp/` with `Authorization: Bearer <key>`. It acts on your account: with a secret key the whole partner API as tools (quotes, orders, eSIMs, top-ups, webhooks, statements); with a publishable key the public tools a traveller-facing assistant needs (prices, quotes, checks, a payment link on Terudo's checkout). Try it with `Bearer pk_test_terudo_demo_public`. Use a test key (`sk_test_…`) while developing. Details: https://terudo.com/developers/mcp/

```bash
claude mcp add --transport http terudo https://terudo.com/api/partner/v1/mcp/ --header "Authorization: Bearer sk_test_…"
```

## Agent skills

Skills teach a coding agent how to integrate Terudo the right way (which element where, keys and sessions, idempotency, webhook signatures, test mode), in the open Agent Skills format (`SKILL.md`), read by Claude Code, Codex, Cursor, Gemini CLI and others.

| Skill | For |
| --- | --- |
| `terudo-elements` | Adding the eSIM offer to a website or web app: booking confirmation, visa approval, trip page, customer area |
| `terudo-api` | Server-side integration: quotes, commission and net orders, eSIMs, top-ups, webhooks, statements |

Install into your project:

```bash
npx -y @terudo/cli skills add            # .claude/skills/ (Claude Code)
npx -y @terudo/cli skills add --agent codex   # .agents/skills/
```

Or download them: https://terudo.com/developers/skills/terudo-elements/SKILL.md and https://terudo.com/developers/skills/terudo-api/SKILL.md. Through the docs MCP: the `get_skill` tool, or the prompts `terudo-elements` and `terudo-api`.

## CLI

`terudo`: read and search the docs, generate snippets, install skills, configure MCP clients, call the API, sign test webhooks. See [CLI](https://terudo.com/developers/docs/cli.md).

## Plain text

- Every docs page in Markdown at its `.md` address, listed in https://terudo.com/developers/docs/index.md
- https://terudo.com/llms.txt: what Terudo is and where everything lives
- https://terudo.com/llms-full.txt: the whole documentation in one file
- https://terudo.com/developers/openapi.json: the API as OpenAPI 3.1