# MCP Server

SumoRouter menyediakan MCP server di `https://ai.brandkamu.id/mcp` (Streamable HTTP, respons JSON),
diautentikasi dengan **admin API key** yang sama dengan [Admin API](/admin/admin-api).

## Claude Code

```bash
claude mcp add --transport http sumorouter-admin https://ai.brandkamu.id/mcp \
  --header "Authorization: Bearer sk-admin-..."
```

## Klien lain

```json
{
  "mcpServers": {
    "sumorouter-admin": {
      "type": "http",
      "url": "https://ai.brandkamu.id/mcp",
      "headers": { "Authorization": "Bearer sk-admin-..." }
    }
  }
}
```

## Tools

`list_users`, `get_user`, `create_user`, `update_user`, `set_user_disabled`, `adjust_user_balance`
(dalam USD), `list_user_topups`, `list_user_keys`, `list_user_requests`, `list_user_activity`,
`list_models`, `update_model`, `sync_models`, `apply_markup`, `set_models_active`, `list_coupons`,
`create_coupon`, `update_coupon`, `list_coupon_redemptions`, `list_affiliates`, `get_settings`,
`update_settings`, `get_analytics`, `list_audit_log`, dan `admin_request` (route `/admin/…` apa pun).

## Keamanan

- Setiap tool call dijalankan sebagai request ke Admin API dengan key pemanggil, jadi read-only,
  allow-list IP, validasi, dan audit log berlaku sama persis.
- Gunakan key **read-only** untuk agent yang hanya perlu membaca data.
- Request dengan header `Origin` browser dari domain lain ditolak (proteksi DNS rebinding).
- Hasil lebih dari 100 kB dipotong; gunakan `limit`/`offset`.