MCP server

The Blnk MCP server exposes your Core instance through the Model Context Protocol (MCP). AI tools such as Cursor, Claude Desktop, and ChatGPT connect to this endpoint, authenticate with Blnk Cloud credentials, and call tools to read or write ledger data. All MCP traffic is routed through Blnk Cloud. AI clients never connect directly to your Core instance. Cloud validates credentials, enforces scopes, and forwards authorized operations to the target instance.

{
  "mcpServers": {
    "blnk": {
      "url": "https://api.cloud.blnkfinance.com/mcp/YOUR_INSTANCE_ID",
      "headers": {
        "X-blnk-key": "CLOUD_API_KEY"
      }
    }
  }
}

Set up your client

Create authentication credentials

Choose either an API key or OAuth credentials. Both need mcp:read and mcp:write.

API Key
OAuth Credentials

Create an API key with MCP scopes in Settings > API Keys.

Create an OAuth client with MCP scopes in Settings > API Keys. Select OAuth as the type when creating.

Get your MCP endpoint

Go to Settings > MCP and copy the configuration for your app.

API Key
OAuth Credentials

{
  "mcpServers": {
    "blnk": {
      "url": "https://api.cloud.blnkfinance.com/mcp/YOUR_INSTANCE_ID",
      "headers": {
        "X-blnk-key": "CLOUD_API_KEY"
      }
    }
  }
}

https://api.cloud.blnkfinance.com/mcp/YOUR_INSTANCE_ID

For OAuth, you only need the MCP endpoint URL. Use your OAuth Client ID and Client Secret for authentication.

Configure your MCP client

Cursor
Claude Desktop
ChatGPT

Open Cursor Settings.
Go to Features > MCP Servers.
Click Add Server.
Paste the configuration from the previous step (full JSON for API keys, or the endpoint URL for OAuth).

Add the configuration from the previous step to claude_desktop_config.json:

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

Go to Settings > Apps.

ChatGPT MCP app configuration form showing fields for Name, MCP Server URL, and OAuth authentication settings

Open Advanced settings and enable Developer mode.
Click Create app.
Fill in the app details:
- Name: Use a clear name like Blnk MCP.
- MCP Server URL: Paste the MCP endpoint URL from the previous step.
- Authentication type: Select OAuth, then enter your Client ID and Client Secret.
Click Create.
Sign in with Blnk Cloud when prompted.
After login, ChatGPT returns with the MCP app configured.

Start chatting with your ledger

You can now query, explore, and update Blnk data from your assistant.

What you can ask

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

Supported tools

Blnk MCP registers 33 tools.

create_ledger - Create a new ledger for organizing balances
get_ledger - Retrieve ledger details by ID
list_ledgers - List all ledgers

create_balance - Create a balance within a ledger
get_balance - Retrieve balance details and current amounts by balance ID
list_balances - List all balances

record_transaction - Record a transaction between two balances
get_transaction - Get a transaction by ID
get_transaction_by_reference - Get a transaction by its unique reference
commit_inflight - Commit an inflight transaction to finalize it
void_inflight - Void an inflight transaction to cancel it
refund_transaction - Create a refund for a transaction
schedule_transaction - Schedule a transaction for future execution
bulk_transactions - Process multiple transactions at once

create_identity - Create a new identity (individual or organization)
get_identity - Retrieve identity details by ID
list_identities - List all identities
update_identity - Update an existing identity
delete_identity - Delete an identity

search - Search across transactions, ledgers, balances, or identities. Requires entity and query.

query_transactions - Query transactions with advanced filters
query_balances - Query balances with advanced filters
query_ledgers - Query ledgers with advanced filters
query_identities - Query identities with advanced filters

Response

Blnk MCP follows the Model Context Protocol specification. Request and response formats, session lifecycle, transport, and error handling are defined by the MCP standard. Most MCP clients handle the protocol automatically. If you are building a custom client, refer to the MCP specification for message structure, initialization, and tool invocation.

Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.

Start Here

Deployments

Proxy & data

Data lake

AI integrations

Audit

Alerts

Billing

Set up your client

What you can ask

Supported tools

Response

Need help?

​Set up your client

​What you can ask

​Supported tools

​Response

​Need help?

Set up your client

What you can ask

Supported tools

Response

Need help?