# MCP · your account

Models, your balance and your receipts, inside your assistant.

The account MCP server lets your assistant read your OpenDunes account while it works: pick a model for a job, then check what a request cost. It answers at `https://opendunes.com/v1/mcp`.

## What it answers

| Tool | Your assistant asks for | It answers |
|---|---|---|
| `list_models` | the models | every model on sale, as [All models](/docs/reference/models) lists them |
| `get_model` | one model | one model on sale, as [One model](/docs/reference/model) answers it |
| `get_balance` | your balance | your balance, in DA, as [Balance](/docs/reference/credits) answers it |
| `list_keys` | your API keys | your keys, as [Keys](/docs/reference/keys) lists them |
| `get_activity` | your activity | your spend in DA per day and model, as [Usage history](/docs/reference/activity) answers it |
| `get_receipt` | one receipt | the receipt of one request: its model, its tokens, its charge in DA, as [Receipt](/docs/reference/generation) answers it |

Ask in your own words: *"Which model should transcribe these recordings? Then check what that request cost."*

## How it signs in

The server signs in with a management key. Create one in *Settings*, under *Management keys*, and your assistant sends it in the `Authorization` header as `Bearer mk-…`. A management key never calls a model, and an API key is refused here. [API keys](/docs/api-keys) says what a management key does.

<div class="watch-out">
<p>The key lets your assistant read your keys, your balance and your usage. Keep it out of shared files, and delete it under <a href="/dashboard/settings/management-keys">Management keys</a> when you stop using the server.</p>
</div>

## Add the server

Set your key in the environment as `OPENDUNES_MANAGEMENT_KEY`, then add the server in one click in Cursor, or in VS Code, which asks for the key and hides it as you type.

<div class="buttons">
<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=opendunes-account&amp;config=eyJ1cmwiOiJodHRwczovL29wZW5kdW5lcy5jb20vdjEvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7ZW52Ok9QRU5EVU5FU19NQU5BR0VNRU5UX0tFWX0ifX0=" class="button primary">Add to Cursor</a>
<a href="vscode:mcp/install?%7B%22name%22%3A%22opendunes-account%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fopendunes.com%2Fv1%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24%7Binput%3Aopendunes-management-key%7D%22%7D%2C%22inputs%22%3A%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22opendunes-management-key%22%2C%22description%22%3A%22OpenDunes%20management%20key%22%2C%22password%22%3Atrue%7D%5D%7D" class="button">Add to VS Code</a>
</div>

In Claude Code, run this in your terminal:

```bash
claude mcp add --transport http opendunes-account https://opendunes.com/v1/mcp \
  --header "Authorization: Bearer $OPENDUNES_MANAGEMENT_KEY"
```

## What it never does

| It never | So |
|---|---|
| runs a model | no request through it is charged |
| changes a key, a cap or a setting | it reads only |
| deposits or spends | your balance moves only with your own requests |

<div class="good-to-know">
<p>To give your assistant the docs themselves, with no sign-in: <a href="/docs/build-with-ai">Build with AI</a>.</p>
</div>
