# focxle MCP server

> Tracks and attributes AI agent costs across multiple vendors by monitoring token usage directly within your process.

- Repository: https://github.com/focxle/focxle-python
- Page: https://hostedmcp.org/servers/focxle/focxle-python
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.1.7

## Install

### Claude Code

```sh
claude mcp add focxle-python -- uvx focxle
```

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

```json
{
  "mcpServers": {
    "focxle-python": {
      "command": "uvx",
      "args": [
        "focxle"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "focxle-python": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "focxle"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"focxle-python","type":"stdio","command":"uvx","args":["focxle"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "focxle-python": {
      "command": "uvx",
      "args": [
        "focxle"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add focxle-python -- uvx focxle
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.focxle-python]
command = "uvx"
args = ["focxle"]
```

### Gemini CLI

```sh
gemini mcp add -s user focxle-python uvx -- focxle
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "focxle-python": {
      "command": "uvx",
      "args": [
        "focxle"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `FOCXLE_NO_HISTORY` | no | no | Set to 1 to stop focxle keeping any local spend history. The server then has nothing to read and will say so. |

## FAQ

### Does focxle require an account or API key to start?

No, it requires no account, no API key, and no config file to work. Prices are included in the package so it works offline.

### Will using focxle break my existing agent code?

The library is designed to fail open, meaning if it fails, your call still goes through and the failure is simply recorded.

### Can I use focxle with my code editor?

Yes, it includes an MCP server that allows you to ask about your agent spend in editors like Claude Code, Cursor, Windsurf, or Zed.

### Does it send my prompts or responses to a server?

No, it does not send agent names, model names, prompts, responses, or URLs. Telemetry is off by default and only sends anonymous vendor totals if you explicitly enable it.