# Kottos AI Account

> Kottos AI Account is an MCP server for ai models and llm tooling. Create a Kottos AI gateway account from an agent, then see request costs and savings. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API, CLI, Web
- **Website:** https://kottos.ai/mcp.html
- **MCP Registry name:** ai.kottos/account
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

Setup happens inside Claude Code, Codex or a chat. After adding the server and signing in with your email, you ask for a setup and the agent works out how far your account is and does only what is left. It creates the account with $10 of credit toward Kottos AI fees, asks you to accept the terms and privacy policy, and writes a token to ~/.kottos/token, readable only by you. Kottos keeps only the token's SHA-256 hash, and the token never passes through the chat.

In Claude Code the connection goes live within about a minute with no restart. Codex gets a kottos profile in its own config file, used with codex -p kottos and an OpenAI key. A chat on Claude or ChatGPT can create the account but cannot make a token on your computer, so that step is one click on the account page.

Once connected, tools report recent requests, spend and Kottos fees over 1, 7 or 30 days, and simulate what past requests would have cost on another model or venue. Provider keys pass through with each request and are never stored. The site says Claude Code is tested while Codex and chats are new, with a limit of 120 requests a minute per address.

## Features

- **Agent-led setup:** The agent creates the account and token, then connects itself after you approve each step.
- **Local token:** The token is written to ~/.kottos/token and only its SHA-256 hash is registered.
- **Spend reporting:** usage and recent_requests show requests, costs and fees for today, 7 or 30 days.
- **Savings simulation:** simulate re-prices your own past requests on another model and venue.
- **Model and venue prices:** list_models and compare_venues show list prices and measured time to first token.
- **Codex profile:** A kottos profile is written so codex -p kottos routes through the gateway.

## Good for

- Set up a gateway account without leaving Claude Code
- Check what recent requests cost, including gateway fees
- Find where the same requests would have cost less
- Route Codex through the gateway with an OpenAI key
- Compare price and latency across venues for a model

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http account https://account.kottos.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://account.kottos.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "account": {
      "url": "https://account.kottos.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "account": {
      "type": "http",
      "url": "https://account.kottos.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "account": {
      "serverUrl": "https://account.kottos.ai/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "account": {
      "type": "http",
      "url": "https://account.kottos.ai/mcp"
    }
  }
}
```

## Tools

- `whoami`: Shows your account, balance and token.
- `create_account`: Creates an account with its starting credit.
- `set_token`: Registers a token made on your computer.
- `get_started`: Gives setup steps for Claude Code, Codex or a chat.
- `list_routes`: Returns settings and code for a first request to Anthropic, OpenAI, Amazon Bedrock or another route.
- `recent_requests`: Shows your last ten requests.
- `usage`: Shows requests, costs and Kottos AI fees for today, 7 or 30 days.
- `simulate`: Shows what past requests would have cost on another model and venue.
- `list_models`: Lists list prices per venue and service tier for a model.
- `compare_venues`: Compares venues by price and time to first token.

## FAQ

### Does the token pass through the chat?

No. The site says it is made on your computer and only its SHA-256 hash is registered.

### How much starting credit is there?

The account is created with $10 of credit for Kottos AI fees.

### Are my provider keys stored?

No. They pass through the gateway with each request and are never stored.

### Is there a rate limit?

Yes, 120 requests a minute from one address, with Claude's and ChatGPT's own servers exempt.

### Is Kottos AI Account free?

Kottos AI Account is a paid product with a free trial.

### How do I add Kottos AI Account to Claude Code?

Run this command in your terminal: claude mcp add --transport http account https://account.kottos.ai/mcp

### What are the best alternatives to Kottos AI Account?

The closest alternatives to Kottos AI Account are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/kottos-ai-account
