Loading...

Bit2Me MCP Server

The ultimate bridge between your crypto finances and Artificial Intelligence. Connect Claude or Cursor to your Bit2Me account to check prices, manage your wallet, and trade with natural language.

Use AI to manage your cryptocurrency portfolio on Bit2Me - check Bitcoin prices, execute trades, stake crypto for rewards, manage loans, and get real-time market data. All through simple conversations with your AI assistant. -- powerful tools available for complete Bit2Me API integration.

Install Server View Tools GitHub NPM Version

What is this?

M

Model Context Protocol

MCP (Model Context Protocol) is an open protocol developed by Anthropic that enables AI assistants like Claude and Cursor to securely connect to external data sources and tools. Think of it as a universal adapter that lets AI access real-world information and perform actions on your behalf. This protocol standardizes how AI assistants interact with APIs, databases, and services, making it easy to extend AI capabilities with custom integrations.

Secure, Standardized, Extensible
₿

Bit2Me

Bit2Me is a leading European cryptocurrency exchange based in Spain that offers wallet services, crypto trading (spot & pro), staking rewards (Earn), and crypto-backed loans. With over 400+ cryptocurrencies supported including Bitcoin, Ethereum, and Solana, it's one of the most comprehensive crypto ecosystems in Europe. Bit2Me provides secure API access for developers to integrate cryptocurrency functionality into their applications.

Wallet, Trading, Staking, Loans

Architecture

🤖
Claude / Cursor
JSON-RPC
B
MCP Server
REST API
🌐
Bit2Me API
💻

Local MCP Server Important

This is a local MCP server that runs on your computer. It communicates directly with your Claude Desktop or IDE, executing API calls on your behalf from your local machine.

🔒

Security & Privacy

Your API keys remain on your local machine and are never sent to any third-party server. All communication happens directly between your computer and Bit2Me's API.

🚀

Coming Soon: Remote MCP Server

We're working on a remote MCP server option that will allow you to access your Bit2Me account from anywhere without local installation. Stay tuned for updates!

Installation

Before you begin

You need API keys to use this server. Go to your Bit2Me API Dashboard and generate a new key.

Recommended Permissions: ✅ Wallets, ✅ Trading, ✅ Earn, ✅ Loans

Note: Withdrawals to external addresses are NOT supported for security.

  1. 1

    Configure Server

    Open the file:

    ~/Library/Application Support/Claude/claude_desktop_config.json
    {
  "mcpServers": {
    "bit2me": {
      "command": "npx",
      "args": ["-y", "@bit2me/mcp-server"],
      "env": {
        "BIT2ME_API_KEY": "YOUR_BIT2ME_ACCOUNT_API_KEY",
        "BIT2ME_API_SECRET": "YOUR_BIT2ME_ACCOUNT_API_SECRET"
      }
    }
  }
}

Testing with MCP Inspector

🔍

What is MCP Inspector?

MCP Inspector is the official debugging tool for MCP servers. It provides a web interface to test your tools, view responses, and debug issues before using them in Claude or other clients.

  1. 1

    Install MCP Inspector

    Install globally via npm:

    npm install -g @modelcontextprotocol/inspector
  2. 2

    Start the Inspector

    Choose one of these options:

    Recommended Option A: Using NPM Package

    Use the published package (no build required):

    export BIT2ME_API_KEY=YOUR_BIT2ME_ACCOUNT_API_KEY
export BIT2ME_API_SECRET=YOUR_BIT2ME_ACCOUNT_API_SECRET
npx @modelcontextprotocol/inspector npx -y @bit2me/mcp-server

    Option B: Using Local Repository

    For development or testing unreleased changes:

    # 1. Clone and build
git clone https://github.com/bit2me-devs/bit2me-mcp.git
cd bit2me-mcp
npm install
npm run build

# 2. Run inspector
export BIT2ME_API_KEY=YOUR_BIT2ME_ACCOUNT_API_KEY
export BIT2ME_API_SECRET=YOUR_BIT2ME_ACCOUNT_API_SECRET
npx @modelcontextprotocol/inspector node build/index.js

    The inspector will automatically open at http://localhost:5173

  3. 3

    Test Your Tools

    The web interface provides:

    • • Tools Tab: View all -- tools, test with parameters, see responses
    • • Request/Response Logs: Debug MCP protocol messages and timing
    • • Live Testing: Execute tools and see formatted results instantly
  4. 4

    Example: Test a Tool

    Try getting Bitcoin price:

    1. Select Tool

    broker_get_asset_data

    2. Enter Parameters

    {
  "base_symbol": "BTC",
  "quote_symbol": "EUR"
}

    3. Click Execute & View Response

    ✓ Success! See live price data, volume, and market info
💡

Pro Tip

Use MCP Inspector to verify your API credentials and test tools before configuring Claude Desktop. It's the fastest way to debug authentication issues or explore available tools.

Tools Reference

Complete list of the -- available tools. Use the sidebar search to filter.

Response Structure

All tool responses follow a consistent JSON structure

"request"

Echo of the input parameters sent to the tool. Useful for debugging and logging which arguments were used.

"result"

The actual data returned by the tool. Can be an object (single item) or an array (list of items) depending on the tool.

"metadata"

Additional context about the response: pagination info, totals, and other useful details.

Metadata Fields

total_records

Total number of items in the result (for lists)

offset

Starting position for paginated results

limit

Maximum items per page requested

has_more

Boolean indicating if more results exist

View example response structure
Example JSON Response
{
  "request": {
    "base_symbol": "BTC",
    "quote_symbol": "EUR"
  },
  "result": [
    {
      "base_symbol": "BTC",
      "quote_symbol": "EUR",
      "price": "95000.50",
      "date": "2024-12-04T10:30:00.000Z"
    }
  ],
  "metadata": {
    "total_records": 1,
    "offset": 0,
    "limit": 100,
    "has_more": false
  }
}

Usage Examples

claude-ai ~ bit2me-mcp
👤

Buy €500 of Bitcoin please

⚡
broker_quote_buy({ amount: "500", symbol: "BTC" }) broker_confirm_quote({ proforma_id: "..." })
🤖

✅ Purchase complete! You bought 0.00526 BTC for €500. Your new BTC balance is 0.45526 BTC.

Frequently Asked Questions

What is MCP (Model Context Protocol)?

MCP (Model Context Protocol) is an open protocol developed by Anthropic that enables AI assistants like Claude to securely connect to external data sources and tools. Think of it as a universal adapter that lets AI access real-world information and perform actions on your behalf.

The Bit2Me MCP Server implements this protocol to bridge your Bit2Me cryptocurrency account with AI assistants, allowing you to manage your crypto portfolio using natural language.

How do I connect Claude AI to Bit2Me?

To connect Claude AI to Bit2Me, follow these steps:

  1. Install the Bit2Me MCP Server via npm: npm install -g @bit2me/mcp-server
  2. Generate API keys from your Bit2Me API Dashboard
  3. Configure your Claude Desktop config file with your API keys
  4. Restart Claude Desktop to load the MCP server

Once connected, you can ask Claude to check crypto prices, manage your wallet, execute trades, stake cryptocurrencies, and more - all using natural language.

What can I do with Bit2Me MCP Server?

The Bit2Me MCP Server provides 51 tools across multiple categories:

  • General: Get asset information, account details, and portfolio valuation. and order books
  • Wallet Management: Query balances, view transaction history, manage pockets
  • Pro Trading: Create limit/market orders, check open orders, view trade history
  • Earn (Staking): Deposit funds for staking rewards, check APY rates, manage Earn wallets
  • Loans: Create crypto-backed loans, manage collateral, check LTV ratios
  • Portfolio: Get complete portfolio valuation across all Bit2Me products
Is Bit2Me MCP Server secure?

Yes, the Bit2Me MCP Server uses secure API authentication with HMAC signatures and follows security best practices:

  • All API requests are authenticated using secure HMAC signatures
  • The server does NOT support withdrawals to external blockchain addresses
  • Only internal transfers between your own Bit2Me wallets are supported (Wallet ↔ Pro ↔ Earn)
  • For maximum security, do NOT enable withdrawal permissions on your API key
  • All sensitive data is automatically sanitized in logs
Do I need a Bit2Me account to use the MCP Server?

Yes, you need a verified Bit2Me account to use the MCP Server. Here's what you need:

  • A verified Bit2Me account (sign up at bit2me.com)
  • API keys generated from the Bit2Me API Dashboard
  • Appropriate permissions enabled based on what you want to use:
    • Wallets permission for wallet operations
    • Trading permission for Pro Trading
    • Earn permission for staking operations
    • Loans permission for loan management
Can I use Bit2Me MCP Server with other AI assistants besides Claude?

Yes! The Bit2Me MCP Server works with any MCP-compatible client. While it's optimized for Claude and Cursor, you can use it with any AI assistant or application that supports the Model Context Protocol standard. The server provides a standardized interface that any MCP client can connect to.

🔒 Error 401: Unauthorized - How do I fix authentication issues?

Your API Keys are invalid or missing permissions. Here's how to fix it:

  • Check for extra spaces in your .env file
  • Verify keys have "Wallets" and "Trading" permissions enabled
  • Ensure you've copied the complete API key and secret without truncation
🔒 Invalid Signature / Nonce - Why are my HMAC signatures failing?

HMAC signatures require precise timing synchronization:

  • Sync your system clock using NTP (Network Time Protocol)
  • Ensure your PC time matches UTC time accurately
  • Check timezone settings if issues persist
📡 Error 429: Rate Limit - Why am I getting rate limited?

Too many requests in a short period. The Bit2Me API has rate limits:

  • get_portfolio_valuation makes 4+ API calls at once
  • Wait 60 seconds before retrying after hitting rate limits
  • Consider spacing out requests or using caching when possible
📡 ECONNRESET / Timeout - Connection issues, what should I do?

Network interruption detected:

  • Check your internet connection stability
  • Bit2Me API might be under maintenance - check status.bit2me.com
  • Retry the request after a few seconds
⚙️ "Insufficient Funds" - Why can't I complete my transaction?

You are trying to spend more than you have available:

  • Check your balance first using wallet_get_pockets
  • Remember that fees are deducted from the total amount
  • Ensure you have enough balance to cover both the transaction and fees
⚙️ "Symbol Not Found" - The trading pair doesn't exist, what's wrong?

The trading pair you're trying to use doesn't exist:

  • Use broker_get_asset_data or general_get_assets_config to check available pairs
  • Format must be BASE-QUOTE (e.g., BTC-USD, ETH-EUR)
  • Ensure both symbols are uppercase and separated by a hyphen
⚠️ Error 400: Bad Request - What parameters are missing or invalid?

Missing or invalid arguments in your request:

  • Verify data types match requirements (string vs number)
  • Ensure all required fields are present in your request
  • Check the tool's documentation for the correct parameter format
⚠️ "Invalid Amount" - How should I format amounts correctly?

Amount format is incorrect:

  • Use dot (.) for decimals, not comma (e.g., 0.5 not 0,5)
  • Check min/max limits using pro_get_market_config for Pro Trading
  • Amounts should be strings, not numbers, for precision
🔧 Error 500/502 - Server errors, what's happening?

Server-side temporary issue:

  • Bit2Me API might be experiencing high load
  • Retry the request after a few seconds
  • Check status.bit2me.com for service status
🔧 Maintenance Mode - Is Bit2Me under maintenance?

System is under scheduled maintenance:

  • Check status.bit2me.com for maintenance schedules
  • Trading might be paused temporarily during maintenance
  • Wait for maintenance to complete before retrying

Contributing

Help Us Improve

We welcome contributions! Whether you're fixing bugs, adding features, improving documentation, or suggesting enhancements, your pull requests help make this project better for everyone.

Found a bug? Have an idea? Want to add a new feature? Open a pull request on GitHub and let's build something amazing together!

Contribute on GitHub

Useful Resources

GitHub Repository NPM Version