Claude Desktop

Step-by-step guide to connect EmbarkAI MCP server with Claude Desktop.

1. Locate the config file

Claude Desktop stores its MCP configuration in claude_desktop_config.json:

Create the file if it does not exist.

2. Add the MCP server

Open the config file and add the embarkai entry under mcpServers:

{
  "mcpServers": {
    "embarkai": {
      "command": "npx",
      "args": ["-y", "@embarkai/mcp"],
      "env": {
        "EMBARK_API_KEY": "your_api_key_here",
        "EMBARK_WALLET_ID": "your_wallet_id_here",
        "EMBARK_CHAIN_ID": "2030232745"
      }
    }
  }
}

Replace your_api_key_here and your_wallet_id_here with your actual credentials from the EmbarkAI dashboard .

With persistent keyshare storage

For production use, enable encrypted file-based keyshare storage so keys survive restarts:

{
  "mcpServers": {
    "embarkai": {
      "command": "npx",
      "args": ["-y", "@embarkai/mcp"],
      "env": {
        "EMBARK_API_KEY": "your_api_key_here",
        "EMBARK_WALLET_ID": "your_wallet_id_here",
        "EMBARK_CHAIN_ID": "2030232745",
        "EMBARK_KEYSHARE_DIR": "/Users/you/.embarkai/keyshares",
        "EMBARK_KEYSHARE_PASSWORD": "a_strong_password"
      }
    }
  }
}

3. Restart Claude Desktop

Quit Claude Desktop completely and reopen it. The MCP server starts automatically when Claude needs it.

4. Verify the tools

After restarting, you should see a hammer icon in the Claude Desktop input area indicating MCP tools are available. Click it to see the list of 7 EmbarkAI tools:

• get_wallet_info
• get_balance
• transfer
• read_contract
• get_transaction_status
• list_supported_chains
• switch_chain

If the tools do not appear, check the Claude Desktop logs for errors:

# macOS
tail -f ~/Library/Logs/Claude/mcp-server-embarkai.log

5. Try it out

Start a conversation and try these prompts:

Check your wallet:

What is my wallet address and what chain am I on?

Check balance:

What is my LUMIA balance?

List chains:

What blockchains are available? Switch me to Sepolia.

Send tokens:

Send 0.1 LUMIA to 0xRecipientAddress

Read a contract:

What is the total supply of the ERC-20 token at 0xTokenAddress?

Claude will ask for confirmation before executing any tool that modifies state (like transfer).

Troubleshooting

Tools not appearing:

• Make sure npx is in your system PATH. Run which npx in a terminal to verify.
• Check that the JSON config is valid (no trailing commas, correct quotes).

“EMBARK_API_KEY is required” error:

• Verify the API key is set correctly in the env block of the config.

Server crashes on startup:

• Ensure Node.js 18+ is installed: node --version
• Try running npx -y @embarkai/mcp manually in a terminal with the env vars exported to see the error.