> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.finrock.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Claude to Finrock

> Connect Claude to your Finrock account by signing in, so it can check balances, create invoices and help you build crypto payments into your app.

Connect Claude to Finrock and Claude can work with your Finrock account (check balances and transactions, create wallets, deposit addresses and invoices) and help you build Finrock payments into your app with working code.

**Server URL:** `https://mcp.finrock.io/mcp`

Setup takes a minute: you add Finrock to Claude, sign in to Finrock, and approve. You never handle API keys or key files.

## What Claude can do

When you approve the connection, you choose an access level:

| Access level | What Claude can do |
| - | - |
| **Read** | See balances, wallets, addresses, transactions, invoices, fees, gas tanks, exchange balances and AML status. |
| **Read and create** | Everything in Read, plus create wallets, deposit addresses and invoices. |

> [!NOTE]
>
> Claude **can't** send funds, sweep, stake, change AML settings, freeze wallets or set up auto-forwarding through this connection, whichever level you choose. This is by design: anything that moves money or changes security settings stays with you in the Finrock dashboard or your own API integration.

For the exact endpoints each access level can call, see [MCP Scopes](https://apidocs.finrock.io/api-reference/mcp-scopes.md).

Claude can also help you build your integration: it reads the latest Finrock docs, writes ready-to-use code for hosted invoices, the payment widget, deposit addresses, webhooks and withdrawals in Node.js, Next.js, Python or PHP, and checks whether a webhook you received has a valid signature.

## Connect

> [tab] Claude (web, desktop and mobile)
>
> **1. Add a custom connector**
>
> Open **Customize → Connectors** and choose **Add custom connector**.
>
> **2. Enter Finrock's details**
>
> 1. Set **Name** to `Finrock`.
> 2. Set the URL to `https://mcp.finrock.io/mcp`.
> 3. Leave the advanced settings empty.
>
> **3. Add and connect**
>
> Click **Add**, then click **Connect**.
>
> **4. Sign in and approve**
>
> A Finrock window opens.
>
> 1. Sign in to Finrock.
> 2. Choose the API user and sub-account Claude should work with.
> 3. Choose the access level: **Read**, or **Read and create**.
> 4. Click **Approve**.
>
> **5. Try it out**
>
> Start a new chat and ask **"List my Finrock wallets"**.
>
> > [!NOTE]
> >
> > On Team and Enterprise plans, an organization owner may need to add the connector first.

> [tab] Claude Code
>
> **1. Add Finrock**
>
> In your terminal, run:
>
> ```bash theme={null}
> claude mcp add --transport http finrock https://mcp.finrock.io/mcp
> ```
>
> **2. Sign in**
>
> 1. In Claude Code, type `/mcp`.
> 2. Pick `finrock`.
> 3. Sign in to Finrock in the browser window that opens, choose the API user, sub-account and access level, and click **Approve**.

> [tab] Other apps
>
> In Cursor, VS Code, ChatGPT, Codex or another app that supports MCP, add `https://mcp.finrock.io/mcp` as a remote (HTTP) MCP server.
>
> Apps that support MCP sign-in open the Finrock sign-in page the first time you use it.

## Try it

Ask Claude in plain language. For example:

* "List my Finrock wallets."
* "What's my USDT balance on Tron?"
* "Create a Finrock invoice for 50 USD, paid in USDT on Tron."
* "Use Finrock to add a crypto checkout to this Next.js app."
* "Verify Finrock webhook signatures in my Express server."

For a guided end-to-end integration, use the **`integrate_finrock`** prompt. In Claude Code, type `/mcp__finrock__integrate_finrock`. In Claude, choose it from the **+** menu under Finrock.

## Manage access

* **To stop Claude's access:** disconnect the Finrock connector in Claude, or, in the Finrock dashboard, open the API user's page under **Users** and click **Disconnect**.
* **To change the access level:** disconnect the connector, connect again, and pick the new level.

## Security

> [!WARNING]
>
> Never paste your private key or API key into a chat. Claude doesn't need them: you connect by signing in to Finrock.

Use a separate API user for Claude, and give it only the sub-accounts it needs. Always review the code Claude writes before deploying it, and test with small amounts first.

## Troubleshooting

* **The sign-in window doesn't open, or Claude says it can't connect.** Check that the URL ends in `/mcp`: `https://mcp.finrock.io/mcp`.
* **"Finrock session expired, please reconnect".** Access was removed or has expired. Click **Connect** again in the connector settings.
* **Claude says it needs more permission.** The connection is read-only. Disconnect, connect again, and pick **Read and create**.
* **Your company network blocks it.** Ask your IT team to allow `mcp.finrock.io` and `api.finrock.io`.
* **Claude doesn't use Finrock.** Make sure the Finrock connector is switched on for the chat, and mention "Finrock" in your request.

***

Use of the Finrock MCP server is subject to the Finrock [Terms of Service](https://finrock.io/terms-of-service) and [Privacy Policy](https://finrock.io/privacy-policy).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.