@blueprintaix/blueprint-mcp

@blueprintaix/blueprint-mcp

An MCP server that connects AI assistants to DeFi yield opportunities across EVM and Solana chains. Discover, evaluate, and execute yield strategies through natural conversation—with transactions signed locally on your machine.

Features

• Multi-chain support — Base (EVM) and Solana, with more chains coming soon
• Local signing — Private keys never leave your machine
• MCP integration — Works with Claude Desktop and other MCP-compatible clients
• Intent execution — Automatically signs and submits transactions

Quick Start

Add the following to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "blueprint": {
      "command": "npx",
      "args": ["-y", "@blueprintaix/blueprint-mcp"],
      "env": {
        "BLUEPRINT_API_KEY": "<your-api-key>",
        "EVM_PRIVATE_KEY": "<your-evm-private-key>",
        "SOLANA_PRIVATE_KEY": "<your-solana-private-key>"
      }
    }
  }
}

Configuration

| Variable | Required | Description | |----------|----------|-------------| | BLUEPRINT_API_KEY | No | API key for Blueprint services (see below for x402 fallback) | | EVM_PRIVATE_KEY | One required | Private key for EVM transactions | | SOLANA_PRIVATE_KEY | One required | Private key for Solana transactions (base58) | | BASE_RPC_URL | No | Custom Base RPC endpoint | | SOLANA_RPC_URL | No | Custom Solana RPC endpoint |

At least one of EVM_PRIVATE_KEY or SOLANA_PRIVATE_KEY must be provided.

x402 Payment Fallback

If no BLUEPRINT_API_KEY is provided, the MCP SDK will automatically fall back to using x402 for making payments to call tools. Payments are made on Base using USDC.

When using x402 payments, EVM_PRIVATE_KEY is required to sign the payment transactions.

Get an API Key

Contact meet@emberlabs.io to request a Blueprint API key, or use x402 payments as described above.

Troubleshooting

Server doesnt start? Check the following:

1. Missing private key for x402 — If using x402 payments (no BLUEPRINT_API_KEY), ensure EVM_PRIVATE_KEY is set
2. Invalid private key format:

• EVM_PRIVATE_KEY must start with 0x (66 characters total)
• SOLANA_PRIVATE_KEY must be base58-encoded (~88 characters)

1. Cached package issue — Clear the npx cache and restart:

   rm -rf ~/.npm/_npx

Still stuck? Check the MCP logs in Claude Desktop (~/Library/Logs/Claude/ mcp-server-bp.log)

License

MIT