machina-mcp

Machina as an MCP server. Use Machina's x402-powered agent services directly from Claude Desktop, Cursor, or any MCP-compatible AI host — no x402 integration required.

Payments happen automatically on every tool call. Configure once, pay per use.

Tools

Payments are in USDC on Base (Coinbase's L2). Gas fees are fractions of a cent.

Related MCP server: agentreader-mcp

Quick Start

1. Install

pip install machina-mcp

2. Get a wallet + fund it

You need an Ethereum wallet with a small USDC balance on Base mainnet.

Option A — New wallet (easiest):

python -c "from eth_account import Account; a = Account.create(); print('Address:', a.address); print('Key:', a.key.hex())"

Copy the address and send it $1–5 USDC on Base via Coinbase or bridge.base.org.

Option B — Existing wallet: Export your private key from MetaMask: Account Details → Export Private Key.

3. Set your key

export MACHINA_WALLET_KEY=0xYOUR_PRIVATE_KEY

4. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "machina": {
      "command": "machina-mcp",
      "env": {
        "MACHINA_WALLET_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Restart Claude Desktop. The 8 Machina tools will appear automatically.

Usage Examples

Once connected, ask Claude:

• "Extract the content from https://example.com" → uses url_extract

• "Scan this Python code for security issues: [paste code]" → uses scan_python

• "Check if john@example.com is a real email" → uses validate_email

• "Get DNS and WHOIS info for openai.com" → uses domain_intel

• "How many pages is this PDF?" → uses pdf_inspect (free)

• "Extract text from report.pdf" → uses pdf_extract

Configuration

Testnet mode (free, mock payments):

export MACHINA_NETWORK=eip155:84532
export MACHINA_BASE_URL=https://mach402.dev  # testnet endpoints at same URL when TESTNET_MODE=true

How payments work

1. Your agent calls a Machina MCP tool (e.g. url_extract)

2. The MCP server sends the request to mach402.dev

3. Machina responds with a 402 Payment Required + exact USDC amount

4. The MCP server signs and sends the x402 payment automatically using your wallet key

5. Machina verifies payment on-chain and returns the result

6. The result is passed back to your agent

The agent never sees any of this — it just calls a tool and gets a result.

Running standalone (for testing)

# Test with MCP Inspector
npx @modelcontextprotocol/inspector machina-mcp

# Or run directly
export MACHINA_WALLET_KEY=0x...
machina-mcp

Pricing

Machina charges per call in USDC on Base mainnet. Payments are settled on-chain via Coinbase CDP. There are no subscriptions, no minimums, no monthly fees.

A $5 USDC balance covers ~1,000 URL extractions or ~250 Python code scans.

Links

• API docs: https://mach402.dev/docs

• Buyer guide: https://mach402.dev/docs/buyer-guide

• Source: https://github.com/NyTerry/machina-mcp

• Issues: https://github.com/NyTerry/machina-mcp/issues

License

MIT