Blnk MCP

Build and query yourledger using AI agents

Let your agent integrate Blnk, query transactions, inspect balances,and look up customers with scoped access.

Ask about your ledger…
Trusted by developers in production:
  • Yousend
  • Public Grid
  • Busha
  • Fast Track
  • Bitnomi

Operate alongside your AI agents. Ask, find, and query your ledger.

Scoped permissions

API keys or OAuth with mcp:read. The agent only gets what you grant.

Works on MCP-compatible tools

Cursor, Claude Desktop, ChatGPT, VS Code, and other clients that speak MCP.

The tools it needs

Your agent gets the tools it needs to query balances, look up transactions, and find identities on your ledger.

Secure agent access

Agents never access your Core directly. Blnk Cloud authenticates every request and securely proxies calls to your Core instance.

Make your agent a Blnk expert. Build with our Documentation MCP.

Claude

Paste the docs MCP URL. No sign-in.

  1. Open connectors

    Go to Claude Settings → Connectors.

  2. Add a custom connector

    Click Add custom connector. Name it Blnk docs.

  3. Paste the docs MCP URL

    Paste the docs MCP URL, then Add. No sign-in.

    MCP URL
    https://docs.blnkfinance.com/mcp

Full docs context

The agent can search and read the live docs, not a snapshot baked into the model.

Embedded agent skills

Run the skills CLI, then start with /blnk. The skills teach maps, architecture, and the recommended Core path.

Best practices

Transactions, inflight, and SDK usage follow the same patterns the docs recommend.

Free to use

No subscription is required to set up the MCP for your product. Learn more

FAQs

Have other questions? Email us at [email protected].

What is the difference between the docs MCP and Cloud MCP?

The docs MCP is public. Your coding agent uses it to search live docs and follow Blnk skills while it writes code. Cloud MCP talks to your ledger through Cloud: you can query balances, find information, or ask what's going on with your ledger.

Do I need a Cloud account?

Only for the Cloud MCP. It needs a Cloud workspace, an instance, and an API key or OAuth client with MCP scopes. The docs MCP however is free and public. Anyone can connect https://docs.blnkfinance.com/mcp.

Is Cloud MCP included in my plan?

Yes. Cloud MCP is available on every Cloud plan, including Sandbox. There is no separate MCP fee.

How do I set up Cloud MCP?

Create an API key or OAuth client with mcp:read and mcp:write in Settings → API keys. Open Settings → MCP, copy the endpoint (and the JSON if you use an API key), and paste it into your client. The setup guide walks through Cursor, Claude Desktop, and ChatGPT.

Which tools can I connect?

Any MCP-compatible client. We document Cursor, Claude Desktop, and ChatGPT. VS Code, Windsurf, and Claude Code work the same way if they speak MCP.

What do the MCP scopes allow?

mcp:read is lookup only: ledgers, balances, transactions, identities, and views. You can use it to ask questions and gain insights into patterns happening in your ledger.

Does the agent connect to my Core directly?

No. Assistants connect to Cloud. Cloud authenticates their credentials, checks the scope, and forwards allowed calls to the open instance via our proxy.

Can I use Cloud MCP with a self-hosted Core?

Yes, if that Core is connected to Cloud. MCP traffic still goes through Cloud, not to the Core’s public API.

How do I install the docs MCP in Cursor?

Add a server that points at https://docs.blnkfinance.com/mcp. For skills, run npx skills add https://docs.blnkfinance.com in the project. The docs MCP page has the steps for Cursor and other clients.

Are the docs MCP and skills free?

Yes. Skills and the docs MCP are free. You only need Cloud when the agent should touch a live ledger. Start with Sandbox if you want both.