Skip to main content
Available on the Pro plan only.

​
Overview

Use Blnk’s MCP (Model Context Protocol) to interact with your Blnk Core & Cloud workspace directly from AI assistants like Cursor, Claude Desktop, and other MCP-compatible tools. Your API key must have mcp:read and/or mcp:write scopes to use MCP functionality.
  • mcp:read: Allows read-only access to your data through MCP
  • mcp:write: Allows read and write access to your data through MCP
For most use cases, you’ll want both mcp:read and mcp:write scopes to fully interact with your Blnk data.

​
Your MCP endpoint

Your Blnk MCP endpoint follows this structure. Your MCP endpoint is automatically generated from the Blnk Core instance currently open in your Blnk Cloud workspace. 
https://api.cloud.blnkfinance.com/mcp/{instance_id}

​
Setting up your MCP

1

Create an API key

Create an API key with available MCP scopes: mcp:read and mcp:write.
You can create API keys in Settings > API Keys in your Blnk dashboard.
2

Get your MCP endpoint

Go to Settings > MCP to get your MCP endpoint URL and copy the configuration to use in your app.Copy this configuration:
{
  "mcpServers": {
    "blnk": {
      "url": "https://api.cloud.blnkfinance.com/mcp/YOUR_INSTANCE_ID",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
To add this configuration in Cursor:
  1. Open Cursor Settings
  2. Navigate to Features > MCP Servers
  3. Click Add Server
  4. Paste the configuration above
3

Start chatting with your ledger

You can now chat with your ledger. Use the AI assistant to query, explore, and interact with your Blnk data.

​
What you can ask your AI assistant

  1. Monitor activity
    • “Show me all transactions from the last 24 hours”
    • “What changed since yesterday?”
  2. Check balances
    • “What is the current balance for wallet bln_wallet_456?”
    • “Show me all negative or low balances”
  3. Investigate issues
    • “Find failed or voided transactions”
    • “Get the transaction with reference order_456”
  4. Review large movements
    • “Show all USD transactions over $5,000”
    • “List unusually large transactions today”
  5. Answer operational questions
    • “How much money moved today?”
    • “What is the total balance across all customer wallets?”

​
Supported tools

Blnk MCP provides 33 tools total across 7 categories for interacting with your data.
  • create_ledger - Create a new ledger for organizing balances
  • get_ledger - Retrieve ledger details by ID
  • list_ledgers - List all ledgers

​
Need help?

If you’re having trouble with Blnk Cloud, don’t hesitate to send us a message via email at [email protected] or send us a message here.