DEV Community

flat cash
flat cash

Posted on

How to connect Claude Desktop to a crypto MCP server in 2 minutes

#ai #mcp #claude #tutorial

Connecting an AI model to real-time financial tools used to require complex backend infrastructure, custom API wrappers, and endless hours debugging authentication flows. Thanks to the Model Context Protocol (MCP), you can now bridge tools directly into AI clients like Claude Desktop in a matter of minutes.

If you want your AI assistant to interact with crypto assets, read live on-chain balances, or evaluate blockchain data seamlessly, setting up a crypto MCP server is the most direct path. This guide will walk you through connecting a crypto MCP server to Claude Desktop in under two minutes.

Prerequisites

Before you begin, ensure you have:

  1. Claude Desktop installed on your macOS or Windows machine. 2 Node.js (v18 or higher) installed on your system (verify via node -v in your terminal).

Step 1: Locate Your Claude Desktop Configuration File

Claude Desktop manages local tools through a JSON configuration file. You need to update this file to tell Claude where to find and run your crypto MCP server.

  1. Open your system's file explorer or terminal.
  2. Navigate to the Claude configuration directory based on your OS:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

If the file does not exist yet, create a new plain text file named claude_desktop_config.json in that directory.

Step 2: Add the Crypto MCP Server to Your Configuration

Open claude_desktop_config.json in your favorite code editor and add the server configuration block.

For example, to spin up a Node-based crypto or financial integration via npx, structure your JSON like this:

{
  "mcpServers": {
    "crypto-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ],
      "env": {
        "CRYPTO_API_KEY": "your_api_key_here"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

(Note: Replace @modelcontextprotocol/server-everything with your specific production crypto MCP package path or custom local server script, and supply any necessary environment variables like network RPC endpoints or keys).

Step 3: Restart Claude Desktop

MCP servers initialize when the application starts up.

  1. Completely quit Claude Desktop (make sure it isn't lingering in your system tray or background processes via Task Manager / Activity Monitor).
  2. Relaunch Claude Desktop.

When Claude boots up, it will read the configuration file, execute the npx command in the background, and establish a local JSON-RPC connection over standard input/output (stdio).

Step 4: Verify the Connection

Open a new chat window in Claude Desktop. You should notice a small hammer or plug icon indicating that external tools are available.

Try prompting Claude with a test query to verify the integration:

"Can you check the current gas prices on Ethereum or look up the latest token balance for my connected address?"

Claude will dynamically call the MCP tools you configured, fetching live context straight into your conversation window.

Streamline Your Workflow with flat.cash

If you are building applications that require programmatic payments, instant settlement, or programmatic handling for your AI workflows, managing custom auth and billing layers can slow you down.

Instead of building complex infrastructure from scratch, check out flat.cash/ask or integrate directly via flat.cash/api/mcp to supercharge your AI agents with seamless transaction capabilities today.

Top comments (0)