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, ChatGPT, and other MCP-compatible tools.
Architecture and security: AI does not have direct access to your Core. All communication flows through Blnk Cloud, which securely connects to your Core and ensures proper security, validation, and access control.
You can authenticate MCP requests using either an API key or OAuth credentials. Both 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 authentication credentials

Choose either an API key or OAuth credentials for authentication. Both require MCP scopes: mcp:read and mcp:write.
Create an API key with MCP scopes.
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 using your API key:
{
  "mcpServers": {
    "blnk": {
      "url": "https://api.cloud.blnkfinance.com/mcp/YOUR_INSTANCE_ID",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
3

Configure your MCP client

Add the configuration to your MCP-compatible tool:
To add this configuration in Cursor:
  1. Open Cursor Settings
  2. Navigate to Features > MCP Servers
  3. Click Add Server
  4. Paste the configuration from the previous step (full JSON for API keys, or endpoint URL for OAuth)
4

Start chatting with your ledger

You can now chat directly with your ledger 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.