@yieldpay/mcp-server

MCP Server for the YieldPay zero-loss payment protocol. Enables AI agents (Claude Code, Cursor, etc.) to discover services, execute payments, and manage vaults on Base L2.

Install

npm install -g @yieldpay/mcp-server

Configure in Claude Code

Add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "yieldpay": {
      "command": "npx",
      "args": ["@yieldpay/mcp-server"],
      "env": {
        "VAULT_ADDRESS": "0xYourVaultAddress",
        "AGENT_PRIVATE_KEY": "0xYourAgentKey",
        "YIELDPAY_NETWORK": "BASE_MAINNET"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | YIELDPAY_NETWORK | No | BASE_MAINNET (default) or BASE_SEPOLIA | | VAULT_ADDRESS | For payments | Your deployed vault address | | AGENT_PRIVATE_KEY | For payments | Agent wallet private key |

Read-only tools (discover, APY, vault info) work without any keys.

Tools

Read-Only (no keys needed)

| Tool | Description | |------|-------------| | discover_services | Browse all active services in the on-chain registry | | get_service_info | Get details of a specific service agent | | get_live_apy | Current AAVE V3 USDC supply APY on Base | | get_vault_info | Read vault balances (principal, float, gas tank) | | calculate_duration | Estimate lock time for delegateYield |

Write (requires AGENT_PRIVATE_KEY)

| Tool | Description | |------|-------------| | fast_pay | Instant payment from yield float | | delegate_yield | Lock capital to generate yield for a service | | register_service | Register as a service provider | | sign_service_request | Sign off-chain payment (zero gas) |

Resources

| Resource | URI | Description | |----------|-----|-------------| | Protocol Info | yieldpay://protocol-info | Overview of YieldPay protocol | | Addresses | yieldpay://addresses | Contract addresses for current network |

Example Conversation

User: What AI services are available on YieldPay?
Claude: [calls discover_services] Found 3 active services...

User: Pay PixelForge $0.02 for an image generation
Claude: [calls fast_pay with service_agent and 0.02] FastPay successful! Tx: ...

User: What's the current yield rate?
Claude: [calls get_live_apy] AAVE V3 USDC APY on Base: 2.79%

License

MIT