> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# TokenLab MCP Server

> Hubungkan klien MCP ke penemuan model, harga, chat kompatibel OpenAI, dan endpoint inferensi native TokenLab.

[TokenLab MCP server](https://github.com/hedging8563/tokenlab-mcp-server) memberikan agen yang kompatibel dengan MCP penemuan model langsung, harga, Chat Completions kompatibel OpenAI, dan alat inferensi native.

Gunakan saat agen perlu membandingkan model, memeriksa format permintaan, mengecek harga, atau memanggil TokenLab melalui OpenAI Chat Completions, Responses, Anthropic Messages, atau Gemini generateContent.

<Note>
  Alat katalog publik tidak memerlukan API key TokenLab. Tetapkan `TOKENLAB_API_KEY` untuk memakai empat alat inferensi berbayar.
</Note>

## Apa yang Disediakan

* Penemuan model secara langsung dari `https://api.tokenlab.sh/v1/models`.
* Pencarian detail model dari `/v1/models/{model}`.
* Pencarian harga dari `/v1/models/{model}/pricing`.
* Ringkasan API yang dapat dibaca agen dari `https://api.tokenlab.sh/llms.txt`.
* Panduan keluarga endpoint untuk chat yang kompatibel dengan OpenAI, Responses, Anthropic Messages, Gemini, media, audio, embeddings, rerank, dan terjemahan.
* Inferensi opsional melalui Chat Completions kompatibel OpenAI, Responses, Anthropic Messages, dan Gemini generateContent.

## Instalasi Dari GitHub

Klon repositori publik dan instal dependensi:

```bash theme={null}
git clone https://github.com/hedging8563/tokenlab-mcp-server.git
cd tokenlab-mcp-server
npm install
npm test
```

Jalankan server melalui stdio:

```bash theme={null}
npm start
```

Variabel lingkungan opsional `TOKENLAB_API_BASE` memiliki nilai default `https://api.tokenlab.sh`.

## Instal di Codex

Tambahkan server katalog publik ke konfigurasi Codex:

```bash theme={null}
codex mcp add tokenlab-model-catalog -- npx -y @tokenlabai/mcp-server
```

Mulai sesi Codex baru setelah menambahkan server. Alat katalog publik tidak memerlukan `TOKENLAB_API_KEY`.

Untuk mengaktifkan alat inferensi, sertakan API key TokenLab saat menambahkan server:

```bash theme={null}
codex mcp add --env TOKENLAB_API_KEY=your-tokenlab-api-key tokenlab-model-catalog -- npx -y @tokenlabai/mcp-server
```

## Instal di Cline

Instal server stdio yang telah dipublikasikan dengan Cline CLI:

```bash theme={null}
cline mcp add tokenlab --yes -- npx -y @tokenlabai/mcp-server
```

Perintah ini telah diverifikasi dengan Cline CLI dan selesai tanpa peringatan penyiapan. Tools katalog publik langsung berfungsi; atur `TOKENLAB_API_KEY` di lingkungan Cline saat membutuhkan tools inferensi.

## Konfigurasi Claude Desktop

Tambahkan package npm yang telah dipublikasikan ke konfigurasi klien MCP:

```json theme={null}
{
  "mcpServers": {
    "tokenlab-model-catalog": {
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server"]
    }
  }
}
```

Mulai ulang klien MCP setelah menyimpan konfigurasi.

## Cursor, Windsurf, Dan Klien MCP Lainnya

Gunakan perintah dan args yang sama di klien mana pun yang mendukung server MCP stdio:

```json theme={null}
{
  "command": "npx",
  "args": ["-y", "@tokenlabai/mcp-server"],
  "env": {
    "TOKENLAB_API_BASE": "https://api.tokenlab.sh"
  }
}
```

Jika klien Anda menyimpan server bernama, gunakan `tokenlab-model-catalog` sebagai nama server.

## Tools

| Tool                       | Tujuan                                                                                                                                                   |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list_models`              | Mencantumkan model TokenLab publik. Secara opsional filter dengan `recommended_for` seperti `image`, `video`, `embedding`, `rerank`, atau `translation`. |
| `get_model`                | Mengambil detail publik satu model dan format permintaan yang didukung.                                                                                  |
| `get_model_pricing`        | Mengambil detail harga publik satu model.                                                                                                                |
| `compare_models`           | Membandingkan detail dan harga beberapa ID model.                                                                                                        |
| `create_chat_completion`   | Memanggil endpoint kompatibel OpenAI `/v1/chat/completions`, dengan pesan multimodal dan tool calling. Memerlukan `TOKENLAB_API_KEY`.                    |
| `create_response`          | Memanggil endpoint `/v1/responses`. Memerlukan `TOKENLAB_API_KEY`.                                                                                       |
| `create_anthropic_message` | Memanggil endpoint Anthropic Messages `/v1/messages`. Memerlukan `TOKENLAB_API_KEY`.                                                                     |
| `create_gemini_content`    | Memanggil endpoint native Gemini `generateContent`. Memerlukan `TOKENLAB_API_KEY`.                                                                       |
| `get_api_overview`         | Mengambil ringkasan `llms.txt` TokenLab untuk panduan endpoint yang dapat dibaca agen.                                                                   |

Alat inferensi mengembalikan hasil JSON biasa. Streaming sengaja dinonaktifkan untuk pemanggilan alat MCP.

## Alur Kerja Agen yang Direkomendasikan

1. Panggil `list_models` ketika pengguna belum menyebutkan nama model.
2. Gunakan `recommended_for` untuk tugas non-chat, seperti image, video, music, 3D, TTS, STT, embeddings, rerank, atau translation.
3. Panggil `get_model` sebelum membuat permintaan non-chat, mencoba kembali permintaan yang gagal, atau beralih keluarga endpoint.
4. Panggil `get_model_pricing` ketika biaya model memengaruhi pilihan pengguna.
5. Gunakan `compare_models` ketika pilihan bergantung pada beberapa kandidat.
6. Panggil alat inferensi yang sesuai dengan kontrak API yang dibutuhkan atau gunakan `get_api_overview` untuk peta ringkas keluarga API TokenLab.

## Panduan Endpoint Native

TokenLab mendukung rute yang kompatibel dengan OpenAI dan keluarga endpoint native. Server MCP membantu agen memilih rute yang tepat sebelum menulis kode:

| Keluarga               | Rute Umum                                                                |
| ---------------------- | ------------------------------------------------------------------------ |
| Chat kompatibel OpenAI | `/v1/chat/completions`                                                   |
| Responses              | `/v1/responses`                                                          |
| Anthropic Messages     | `/v1/messages`                                                           |
| Gemini native          | `/v1beta/models/{model}:generateContent`                                 |
| Images                 | `/v1/images/generations`, `/v1/images/edits`                             |
| Video                  | `/v1/videos/generations`                                                 |
| Music                  | `/v1/music/generations`                                                  |
| 3D                     | `/v1/3d/generations`                                                     |
| Audio                  | `/v1/audio/speech`, `/v1/audio/transcriptions`, `/v1/audio/translations` |
| Embeddings dan rerank  | `/v1/embeddings`, `/v1/rerank`                                           |
| Terjemahan teks        | `/v1/translations`                                                       |

## Model Explorer Terhosting

Klien yang mendukung Streamable HTTP dapat terhubung ke:

```text theme={null}
https://tokenlab-model-explorer.vercel.app/mcp
```

Explorer terhosting bersifat publik dan menyediakan `open_tokenlab_model_explorer`, `compare_tokenlab_models`, serta `generate_tokenlab_endpoint_example`. Gunakan server npm lokal di atas untuk sembilan tools lengkap atau inferensi dengan kredensial.

## Gunakan Dengan TokenLab Skills

Server MCP berguna saat runtime, sementara [repositori TokenLab skills](https://github.com/hedging8563/tokenlab-skills) mengajarkan agen pengodean cara membuat dan memperbaiki kode integrasi.

Gunakan keduanya jika tersedia:

* MCP server: menemukan model saat ini, harga, dan detail endpoint.
* Skill `tokenlab-api-integration`: membuat contoh API yang dapat dijalankan dan menangani error TokenLab yang terstruktur.
* Skill `tokenlab-model-picker`: memilih model yang kuat untuk tugas pengguna.
* Skill `tokenlab-native-endpoints`: memutuskan kapan harus menggunakan rute Responses, Anthropic Messages, Gemini, media, audio, embedding, rerank, atau translation.

## Pemecahan Masalah

<AccordionGroup>
  <Accordion title="Klien tidak dapat memulai server">
    Pastikan Node.js minimal versi 18.17, lalu jalankan `npx -y @tokenlabai/mcp-server` sekali di terminal untuk melihat error npm atau jaringan.
  </Accordion>

  <Accordion title="Daftar model kosong">
    Verifikasi bahwa mesin dapat menjangkau `https://api.tokenlab.sh/v1/models`. Jika Anda mengganti `TOKENLAB_API_BASE`, pastikan tidak menyertakan garis miring (trailing slash) di akhir.
  </Accordion>

  <Accordion title="Agen masih memilih ID model yang kedaluwarsa">
    Minta agen untuk memanggil `list_models` atau `get_model` sebelum melakukan hardcode nama model. Memasangkan server MCP dengan `tokenlab-model-picker` memberikan hasil yang lebih baik.
  </Accordion>

  <Accordion title="Bisakah server ini memanggil API inferensi TokenLab berbayar?">
    Bisa. Tetapkan `TOKENLAB_API_KEY`, lalu gunakan `create_chat_completion`, `create_response`, `create_anthropic_message`, atau `create_gemini_content`. Alat katalog dan harga tetap tersedia tanpa key.
  </Accordion>
</AccordionGroup>

## Sumber Daya

<CardGroup cols={2}>
  <Card title="Repositori GitHub" icon="github" href="https://github.com/hedging8563/tokenlab-mcp-server">
    Kode sumber dan instruksi pengaturan lokal
  </Card>

  <Card title="TokenLab Skills" icon="sparkles" href="https://github.com/hedging8563/tokenlab-skills">
    Skill agen yang dikelola untuk integrasi TokenLab
  </Card>

  <Card title="API Katalog Model" icon="list" href="https://api.tokenlab.sh/v1/models">
    Endpoint penemuan model publik
  </Card>

  <Card title="llms.txt" icon="file-lines" href="https://api.tokenlab.sh/llms.txt">
    Ringkasan API TokenLab yang dapat dibaca agen
  </Card>

  <Card title="Server MCP Glama" icon="globe" href="https://glama.ai/mcp/servers/hedging8563/tokenlab-mcp-server">
    Lihat listing TokenLab MCP Server yang terverifikasi
  </Card>

  <Card title="Penjelajah Model Glama" icon="search" href="https://glama.ai/mcp/servers/hedging8563/tokenlab-openai-apps-model-explorer">
    Jelajahi model, harga, dan contoh endpoint native
  </Card>

  <Card title="Listing MCP.so" icon="compass" href="https://mcp.so/servers/tokenlab-mcp-server">
    Temukan TokenLab di direktori AI & Agents
  </Card>

  <Card title="Model Explorer Terhosting" icon="rocket" href="https://tokenlab-model-explorer.vercel.app">
    Buka model explorer publik dan endpoint MCP jarak jauh
  </Card>
</CardGroup>