Overview

The Model Context Protocol (MCP) connects OneBalance’s documentation and API directly to your AI tools. Choose between our hosted MCP server for instant setup or self-hosted installation for advanced configurations. The simplest way to connect OneBalance to your AI tools is using our hosted MCP server:
https://docs.onebalance.io/mcp

Setup for Claude

1

Add OneBalance MCP server

  1. Navigate to Connectors in Claude settings
  2. Select Add custom connector
  3. Enter name: “OneBalance MCP” and URL: https://docs.onebalance.io/mcp
  4. Select Add
2

Use in your chats

  1. When chatting with Claude, select the attachments button (plus icon)
  2. Select “OneBalance MCP”
  3. Query Claude with OneBalance context and API access

Setup for Cursor

1

Open MCP settings

  1. Press Command + Shift + P (or Ctrl + Shift + P on Windows)
  2. Search for “Open MCP settings”
  3. Select Add custom MCP to open mcp.json
2

Configure OneBalance server

Add to your mcp.json:
mcp.json
{
  "mcpServers": {
    "onebalance-mcp": {
      "url": "https://docs.onebalance.io/mcp"
    }
  }
}
3

Test connection

Ask in Cursor chat: “What tools do you have available?” You should see OneBalance documentation search and API tools.

Self-Hosted MCP (Advanced)

For advanced users who prefer local installation:
npx mint-mcp add onebalance-d7e5d4d0
You’ll see this output:
🛠  Installing Tools:

   search - Documentation search
   predict-smart-account-address - Get smart account addresses  
   list-supported-aggregated-assets - View supported assets
   get-aggregated-balance - Fetch account balances
   list-supported-chains - View supported networks
   get-quote-status - Check quote execution status
   get-transaction-history - Retrieve transaction history
   get-quote - Request transfer/swap quotes
   prepare-call-quote - Prepare contract calls
   get-call-quote - Get contract call quotes
   execute-quote - Execute quotes

✔  What is the API Key for "OneBalance API"? … 
✔  Created new MCP server at ~/.mcp/onebalance-d7e5d4d0
✔  Select MCP client: › All
✔  Successfully installed MCP server to Cursor, Claude Desktop

To start your MCP server, run:
node ~/.mcp/onebalance-d7e5d4d0/src/index.js

Self-Hosted Setup Steps

  1. Run the install command above
  2. Enter your OneBalance API key when prompted
  3. Select MCP clients (Cursor, Windsurf, Claude Desktop, or All)
  4. Start the server with the provided command
For testing purposes, you can use our public API key with limited usage:
42bb629272001ee1163ca0dbbbc07bcbb0ef57a57baf16c4b1d4672db4562c11

Available Functions

Both hosted and self-hosted MCP provide these capabilities: Documentation:
  • search - Search OneBalance docs for relevant context
API Functions:
  • Account management, balance queries, quote generation
  • Transaction history, contract calls, asset information
  • Complete OneBalance platform access

Authentication

When using API endpoints, AI tools will prompt you for your OneBalance API key as needed. Get your API key from the authentication page.

Usage

Once configured, use these functions directly in your AI tools:
  • Ask questions about OneBalance integration
  • Get live data from your smart contract accounts
  • Generate code with current API context
  • Search docs without leaving your editor
Need help? Use the Intercom chat widget in the bottom right corner for instant assistance, or contact support@onebalance.io.