> For the complete documentation index, see [llms.txt](https://docs.avici.money/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avici.money/getting-started/avici-cli-and-mcp/adding-mcp-to-claude-app-beta.md).

# Adding MCP to Claude app (beta)

## Adding MCP to Claude App

Connect Avici to Claude or Claude Desktop using Avici’s hosted MCP server.

There is nothing to install on your computer. Authentication happens through a secure Avici login page.

> **Beta**
>
> Avici is not yet approved in Claude’s official plugin directory. For now, Avici must be added as a custom MCP connector.
>
> Claude’s custom connector feature is also in beta. The official Avici plugin is coming soon.

### Before you start

You need:

* A Claude account with access to custom connectors
* Access to the email attached to your Avici account
* An internet connection

Free accounts may be limited to one custom connector. Team and Enterprise workspaces require an Owner or Primary Owner to add the connector first.

### Add Avici to an individual account

<figure><img src="/files/JSeplqASUZFXpUHpCv51" alt=""><figcaption></figcaption></figure>

1. Open Claude or Claude Desktop.
2. Go to **Customize → Connectors**.
3. Select **+**.
4. Select **Add custom connector**.
5. Enter the following details:

| Field          | Value                           |
| -------------- | ------------------------------- |
| Connector name | `Avici`                         |
| Connector URL  | `https://mcp.avici.money/setup` |

6. Leave the advanced OAuth client fields empty.
7. Select **Add**.
8. Select **Connect** next to Avici.

### Connect your Avici account

Claude will open the Avici login page.

1. Enter the email attached to your Avici account.
2. Request a one-time code.
3. Enter the code sent to your email.
4. If more than one Avici account is found, select the account you want Claude to use.
5. Return to Claude after the connection is approved.

### Team and Enterprise workspaces

An Owner or Primary Owner must first add Avici for the organization:

1. Open **Organization settings**.
2. Select **Connectors**.
3. Select **Add**.
4. Choose **Custom → Web**.
5. Enter:

```
Name: Avici
URL: https://mcp.avici.money/setup
```

6. Add the connector.

Members can then open **Customize → Connectors** and connect their own Avici accounts.

### Enable Avici in a chat

1. Start a new Claude chat.
2. Select the **+** button beside the message box.
3. Open **Connectors**.
4. Enable **Avici**.
5. Ask:

```
Show me my Avici account.
```

### Example questions

```
What is my Avici wallet balance?
```

```
Show my token holdings by network.
```

```
How much is available to spend on my card?
```

```
Show my latest card purchases.
```

### What Claude can access

After connecting, Claude can read your:

* Wallet balance and token holdings
* Cards and available spending power
* Card purchases
* Transaction activity
* Refunds

Avici MCP is read-only. It cannot send, swap, top up, withdraw, bridge, transfer, approve, or otherwise move money.

### Full card details

Full card details require local decryption and are not available through a normal Claude web chat.

Use the Avici CLI with Claude Code if you need to explicitly request the number, expiry, and security code for a specific card.

### Disconnect Avici

1. Open **Customize → Connectors**.
2. Find **Avici**.
3. Open its options.
4. Select **Disconnect** or **Remove**.

You can add Avici again and complete login whenever needed.