Which integrations are available for this server?

Allows sending and receiving USDC (a stablecoin from Circle) on the Base blockchain for payments. Operates on the Base network, a layer-2 blockchain built by Coinbase, providing fast and low-cost USDC transactions.

How do I use pay-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@pay-mcp Check my USDC balance" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

pay-mcp

by MonadWorks

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

Pay-MCP 💸

MCP server for USDC payments on Base — Enable any Claude Code agent to send and receive payments.

🎯 Overview

Pay-MCP is a Model Context Protocol (MCP) server that wraps USDC payment capabilities on the Base blockchain. It allows AI agents (like Claude Code) to:

💰 Check USDC balances — Query any wallet's USDC balance
📤 Send USDC payments — Transfer USDC to any address
📥 Generate payment requests — Create payment links with deep linking support
📜 View transaction history — List recent sent/received transfers

Related MCP server: @true402.dev/mcp-server

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                         Your Computer                           │
│  ┌─────────────────┐     stdio      ┌──────────────────────┐   │
│  │   Claude Code   │◄──────────────►│      Pay-MCP         │   │
│  │  (MCP Client)   │   JSON-RPC     │    (MCP Server)      │   │
│  └─────────────────┘                │                      │   │
│                                     │  ┌────────────────┐  │   │
│                                     │  │  PayWallet     │  │   │
│                                     │  │  ├─ viem       │  │   │
│                                     │  │  └─ ERC-20 ABI │  │   │
│                                     │  └────────────────┘  │   │
│                                     └──────────┬───────────┘   │
└────────────────────────────────────────────────┼───────────────┘
                                                 │ HTTPS/RPC
                                                 ▼
                                     ┌──────────────────────┐
                                     │    Base Blockchain   │
                                     │  ┌────────────────┐  │
                                     │  │  USDC Contract │  │
                                     │  │  (Circle)      │  │
                                     │  └────────────────┘  │
                                     └──────────────────────┘

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/koriyoshi2041/pay-mcp.git
cd pay-mcp

# Install dependencies
npm install

# Build
npm run build

Configuration

Copy the example environment file:

cp .env.example .env

Edit .env with your private key:

# Required: Your wallet's private key
PRIVATE_KEY=your_private_key_here

# Optional: Network (mainnet or testnet)
NETWORK=mainnet

⚠️ Security Warning: Never commit your .env file or share your private key!

Add to Claude Code

Add this to your Claude Code MCP settings:

Location: ~/.claude/claude_desktop_config.json (macOS/Linux) or via Claude Code settings

{
  "mcpServers": {
    "pay-mcp": {
      "command": "node",
      "args": ["/path/to/pay-mcp/dist/index.js"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here",
        "NETWORK": "mainnet"
      }
    }
  }
}

Alternative: Run directly with source:

{
  "mcpServers": {
    "pay-mcp": {
      "command": "npx",
      "args": ["tsx", "/path/to/pay-mcp/src/index.ts"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here",
        "NETWORK": "mainnet"
      }
    }
  }
}

🛠️ Tools

`pay_balance`

Check USDC balance for your wallet or any address.

Parameter	Required	Description
`address`	No	Address to check. Defaults to your wallet.

Example prompt:

Check my USDC balance

`pay_send`

Send USDC to an address.

Parameter	Required	Description
`to`	Yes	Recipient address (0x...)
`amount`	Yes	Amount in USDC (e.g., "10.50")
`memo`	No	Note for this payment

Example prompt:

Send 25 USDC to 0x742d35Cc6634C0532925a3b844Bc9e7595f8d123 for "Coffee subscription"

`pay_request`

Generate a payment request link.

Parameter	Required	Description
`amount`	Yes	Amount to request in USDC
`memo`	No	Description for the request

Example prompt:

Create a payment request for 50 USDC for "Consulting services"

`pay_history`

View recent USDC transactions.

Parameter	Required	Description
`limit`	No	Number of transactions (default: 20, max: 100)

Example prompt:

Show my last 10 USDC transactions

💻 Development

Project Structure

pay-mcp/
├── src/
│   ├── index.ts      # MCP server entry point
│   ├── config.ts     # Configuration and constants
│   ├── wallet.ts     # Blockchain interaction layer (viem)
│   └── tools.ts      # MCP tool definitions
├── test/
│   └── test.ts       # Test script
├── dist/             # Compiled output
├── .env.example      # Environment template
├── package.json
├── tsconfig.json
└── README.md

Commands

# Build TypeScript
npm run build

# Run in development mode
npm run dev

# Run tests (uses testnet)
npm test

# Clean build output
npm run clean

Running Tests

# Run with auto-generated test wallet
npm test

# Run with your own testnet wallet
PRIVATE_KEY=your_testnet_key npm test

🌐 Network Configuration

Mainnet (Default)

Setting	Value
Chain	Base (Chain ID: 8453)
USDC Contract	`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
Explorer	https://basescan.org

Testnet

Set NETWORK=testnet in your .env:

Setting	Value
Chain	Base Sepolia (Chain ID: 84532)
USDC Contract	`0x036CbD53842c5426634e7929541eC2318f3dCF7e`
Explorer	https://sepolia.basescan.org

💡 To get testnet USDC, use the Base Sepolia Faucet.

⚙️ Environment Variables

Variable	Required	Default	Description
`PRIVATE_KEY`	✅ Yes	-	Wallet private key (without 0x prefix)
`NETWORK`	No	`mainnet`	`mainnet` or `testnet`
`BASE_RPC_URL`	No	Public RPC	Custom RPC endpoint
`GAS_MULTIPLIER`	No	`1.1`	Gas estimate multiplier
`MAX_GAS_LIMIT`	No	`100000`	Maximum gas limit

🔒 Security Considerations

Private Key Storage:
- Never commit your private key to version control
- Consider using environment variables or a secrets manager
- For production, use hardware wallets or key management services
Transaction Safety:
- Always test on testnet first
- Double-check recipient addresses
- Consider implementing daily/per-transaction limits
Network Selection:
- Verify network configuration before mainnet transactions
- Use testnet for development and testing

🔧 Tech Stack

Component	Technology
Runtime	Node.js 18+
Language	TypeScript 5.7
MCP SDK	@modelcontextprotocol/sdk
Blockchain	viem
Validation	zod

🤝 Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Make your changes
Run tests (npm test)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

Model Context Protocol by Anthropic
Base by Coinbase
Circle USDC
Viem - TypeScript Ethereum library

Available Tools

4 tools

pay_balanceA

Check USDC balance on Base. Returns the balance for your wallet or a specified address.

Inputs: address.

pay_historyA

Get recent USDC transaction history on Base. Shows both sent and received transfers.

Inputs: limit.

pay_requestA

Generate a payment request. Creates a payment link that others can use to send you USDC.

Inputs: amount (required), memo.

pay_sendB

Send USDC payment on Base. Transfers USDC to the specified address.

Inputs: to (required), amount (required), memo.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored 2026-08-02 13:25 across 4 tools

Disambiguation5/5

Each tool has a distinct purpose: balance checking, sending, requesting, and viewing history. There is no overlap or ambiguity between them.

Naming Consistency4/5

All tools share the 'pay_' prefix and use snake_case, which is consistent. However, 'pay_balance' and 'pay_history' are noun-based while 'pay_send' is verb-based, a minor deviation from a pure verb_noun pattern.

Tool Count5/5

Four tools cover the core functionality of a simple USDC payment server without bloat. The count is well-scoped for the domain.

Completeness5/5

The toolset covers the essential lifecycle: checking balance, sending payments, requesting payments, and viewing transaction history. No critical operations are missing for a basic payment server.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

PHANTOM ID — agent payments (USDC on Base)A
io.github.Arbromagency-Sato
PHANTOM ID MCP payment server: agent-to-agent USDC payments on Base.
Payments & Billing Cryptocurrency Blockchain
71
https://pay.idphantom.com/mcp
zooidfundA
fund.zooid
MCP server for AI agents to discover campaigns by humans and donate USDC directly on Base.
Blockchain Finance Web3 & Decentralized Tech
92
https://fcefnmdlggldmfusydix.supabase.co/functions/v1/mcp
Pyrimid ProtocolA
ai.pyrimid
Agent-commerce MCP server for x402/USDC payments and affiliate splits on Base.
Cryptocurrency Blockchain Payments & Billing
2
https://pyrimid.ai/api/mcp
AbaPayA
io.github.investorphem
Non-custodial stablecoin bill-pay rails on Celo & Base for AI agents, settled on-chain via MCP.
Blockchain Cryptocurrency Payments & Billing
1111
https://agents.abapays.com/api/mcp

Related MCP Servers

forgemesh-imagegenofficial
AI & Machine Learning Image & Video Processing Blockchain
forgemeshlabs
A
license
A
quality
B
maintenance
MCP server for AI image generation with automatic USDC payments on Base mainnet. Generate, remove backgrounds, and upscale images via simple tool calls.
Updated 2 days ago (2026-11-13 14:07 UTC)
4
515 npm
1
MIT
@true402.dev/mcp-server
AI & Machine Learning Cryptocurrency Web Scraping
true402
A
license
A
quality
B
maintenance
An MCP server that enables AI agents to access paid AI inference and web tools via HTTP 402 micropayments in USDC on Base, using the agent's wallet as identity.
Updated 21 days ago (2026-10-25 12:10 UTC)
36
124 npm
MIT
xpay
Cryptocurrency Blockchain E-commerce & Retail
xona-labs
A
license
Not graded
quality
C
maintenance
An MCP server for agentic commerce, enabling AI agents to discover services, make x402 payments with USDC across multiple chains, and manage crypto wallets and token swaps.
Updated 9 days ago (2026-11-06 12:26 UTC)
339 npm
1
MIT
zunivo-mcpofficial
Cryptocurrency Blockchain Web3 & Decentralized Tech
zunivo-pay
A
license
A
quality
C
maintenance
MCP server that lets AI agents discover and pay for .agent services using USDC over x402, with daily budget controls and payment link creation.
Updated 18 days ago (2026-10-28 15:57 UTC)
6
25 npm
MIT

Pay-MCP 💸

🎯 Overview

🏗️ Architecture

🚀 Quick Start

Installation

Configuration

Add to Claude Code

🛠️ Tools

pay_balance

pay_send

pay_request

pay_history

💻 Development

Project Structure

Commands

Running Tests

🌐 Network Configuration

Mainnet (Default)

Testnet

⚙️ Environment Variables

🔒 Security Considerations

🔧 Tech Stack

🤝 Contributing

📄 License

🙏 Acknowledgments

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

forgemesh-imagegenofficial

@true402.dev/mcp-server

xpay

zunivo-mcpofficial

`pay_balance`

`pay_send`

`pay_request`

`pay_history`