Overview
The Model Context Protocol (MCP) connects OneBalance’s documentation and API directly to your AI tools using our hosted MCP server for instant setup.Setup Instructions
General
Our MCP server supports the Streamable HTTP transport and is centrally hosted at:42bb629272001ee1163ca0dbbbc07bcbb0ef57a57baf16c4b1d4672db4562c11
Claude
Team, Enterprise (Claude.ai)- Navigate to Connectors in Claude settings
- Select Add custom connector
- Enter name: “OneBalance MCP” and URL:
https://docs.onebalance.io/mcp
- Select Add
- When chatting with Claude, select the attachments button (plus icon)
- Select “OneBalance MCP” to query Claude with OneBalance context and API access
- Open the file
~/Library/Application Support/Claude/claude_desktop_config.json
- Add the following and restart the Claude desktop app:
Cursor
Install from Cursor’s settings or add manually:- Press Command + Shift + P (or Ctrl + Shift + P on Windows)
- Search for “Open MCP settings”
- Add to your
mcp.json
:
- Ask in Cursor chat: “What tools do you have available?” to confirm connection
Visual Studio Code
- Press Ctrl/Cmd + P and search for MCP: Add Server
- Select Command (stdio)
- Enter the following configuration:
- Enter the name OneBalance and press enter
- Activate using MCP: List Servers, select OneBalance, then Start Server
Windsurf
- Press Ctrl/Cmd + , to open Windsurf settings
- Scroll to Cascade → MCP servers
- Select Add Server → Add custom server
- Add the following:
Zed
- Press Cmd + , to open Zed settings
- Add the following:
Other MCP-Compatible Tools
Many other tools support MCP servers. Configure them with these settings:- Command:
npx
- Arguments:
-y mcp-remote https://docs.onebalance.io/mcp
- Environment: None
Available Tools
The hosted MCP server provides these capabilities: Documentation:SearchOneBalanceDocs
- Search across the OneBalance Docs knowledge base
predictAddress
- Predict smart account addresses before deploymentlistAggregatedAssets
- List all supported aggregated assetsgetAggregatedBalance
- Fetch aggregated balances for EVM accountsgetAggregatedBalanceV3
- Fetch balances with multi-chain support (EVM + Solana)supportedChains
- List all supported blockchain networks
getCallsStatus
- Check quote execution status and transaction hashesgetCallsStatusV3
- Check status with multi-blockchain supportgetCallsHistory
- Retrieve transaction history for EVM accountsgetCallsHistoryV3
- Retrieve history with multi-chain support
getQuote
- Request transfer/swap quotes for EVM chainsgetQuoteV3
- Request quotes with multi-account support (EVM + Solana)prepareCallQuote
- Prepare contract call operationsgetCallQuote
- Get quotes for contract interactionsexecuteQuote
- Execute transfer/swap quotesexecuteQuoteV3
- Execute quotes with multi-chain supportprepareCallQuoteV3
- Prepare contract calls with multi-account supportgetCallQuoteV3
- Get contract quotes with multi-account support
Authentication
Get your production API key from the authentication page. For testing purposes, you can use our public API key:42bb629272001ee1163ca0dbbbc07bcbb0ef57a57baf16c4b1d4672db4562c11
AI tools will prompt you for the API key when accessing OneBalance functions. The MCP server handles authentication automatically once configured.
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
FAQ
Why am I seeing a connection error when trying to connect?
Why am I seeing a connection error when trying to connect?
Check that you’re using the correct URL:
https://docs.onebalance.io/mcp
. If you’re using Claude Desktop or other clients that require mcp-remote
, ensure you have the latest version of Node.js installed.I'm not being prompted for my API key
I'm not being prompted for my API key
The MCP server will only prompt for API keys when you try to use OneBalance API functions. Documentation search works without authentication. Try asking: “What’s my aggregated balance?” to trigger the API key prompt.
Can I use my own API keys instead of the public test key?
Can I use my own API keys instead of the public test key?
Yes! Get your production API key from the authentication page. The MCP server will prompt you to enter it when accessing OneBalance functions, and it will be securely stored for future use.
Which transport protocol does OneBalance MCP support?
Which transport protocol does OneBalance MCP support?
OneBalance MCP server supports Streamable HTTP transport at
https://docs.onebalance.io/mcp
. For clients that don’t support direct HTTP connections, use mcp-remote
as shown in the setup instructions.I'm using WSL on Windows and seeing errors
I'm using WSL on Windows and seeing errors
Try updating your configuration to use WSL explicitly:
Example Prompts
Ready-to-use prompts to explore OneBalance capabilities
Building with LLMs
Learn about other AI integration options with OneBalance
Need help? Use the Intercom chat widget in the bottom right corner for instant assistance, or contact support@onebalance.io.