Yativo Agentic Wallet MCP Server

MCP (Model Context Protocol) server that gives AI agents direct access to Yativo's MPC crypto wallets. Supports balance checks, payments, transaction history, and x402 auto-pay for paywalled APIs.

Quick Start

cd yativo-crypto-mcp
npm install

Configuration

Set these environment variables:

| Variable | Required | Description | |----------|----------|-------------| | YATIVO_API_KEY | Yes | Connector API key (starts with yac_) | | YATIVO_WALLET_ID | Recommended | Default wallet ID (starts with aw_) | | YATIVO_API_URL | No | API base URL (default: https://crypto-api.yativo.com/api/v1) |

Claude Desktop Setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "yativo-wallet": {
      "command": "node",
      "args": ["/path/to/yativo-crypto-mcp/src/index.js"],
      "env": {
        "YATIVO_API_KEY": "yac_your_connector_api_key_here",
        "YATIVO_WALLET_ID": "aw_your_wallet_id"
      }
    }
  }
}

VS Code / Copilot Setup

Add to .vscode/mcp.json:

{
  "servers": {
    "yativo-wallet": {
      "command": "node",
      "args": ["${workspaceFolder}/yativo-crypto-mcp/src/index.js"],
      "env": {
        "YATIVO_API_KEY": "yac_your_connector_api_key_here",
        "YATIVO_WALLET_ID": "aw_your_wallet_id"
      }
    }
  }
}

Available Tools

get_balance

Check wallet balance and address.

"Check my wallet balance"

send_payment

Send crypto to a recipient address. Requires audit trail fields.

"Send $25 USDC to 0x742d...D18 for the API subscription"

x402_fetch

Fetch a URL with automatic x402 payment. If the server returns HTTP 402 with x402 headers, the wallet signs a USDC payment and retries.

"Fetch https://api.example.com/premium/data — pay if it's x402 paywalled"

get_transactions

View recent transaction history.

"Show my last 5 transactions"

Resources

wallet://info

Returns the current wallet's ID, address, chain, and balance as JSON.

How x402 Works

When you ask the agent to fetch a URL:

1. The MCP server calls POST /agent/x402-fetch
2. The backend fetches the URL
3. If the server returns HTTP 402 with an X-PAYMENT header:
   • Parses USDC payment requirements
   • Signs an EIP-3009 transferWithAuthorization with the MPC key
   • Retries the request with the payment signature
4. Returns the actual API response to the agent
5. Records the payment with full audit trail

Supported: USDC on Ethereum, Base, Polygon, Arbitrum, Optimism, Gnosis.