Skip to main content
POST
/
mcp
/
{instance_id}
curl -X POST 'https://api.cloud.blnkfinance.com/mcp/YOUR_INSTANCE_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json'
The Blnk MCP server exposes your Core instance through the Model Context Protocol (MCP). AI assistants and MCP-compatible clients 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. Blnk Cloud validates credentials, enforces scopes, and forwards authorized operations to the target instance.
For client setup in Cursor, Claude Desktop, ChatGPT, and other tools, see the MCP integration guide.

​
Request structure

curl -X POST 'https://api.cloud.blnkfinance.com/mcp/YOUR_INSTANCE_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json'
​
instance_id
string
required
Unique identifier of the Blnk Core instance to connect to. Find this in Settings > MCP in your Blnk Cloud dashboard, or from the instance currently open in your workspace.
​
Authorization
string
required
Bearer token for API key or OAuth access token. Format: Bearer YOUR_API_KEY or Bearer YOUR_ACCESS_TOKEN.
Credentials must include one or both MCP scopes:
ScopeAccess
mcp:readRead-only access to data through MCP tools
mcp:writeRead and write access through MCP tools
Create credentials with MCP scopes in API keys or OAuth clients.

​
Response structure

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. For the list of supported tools, see Supported tools in the MCP integration guide.

​
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.