Payment MCP

🚀 Payment-MCP

A Model Context Protocol (MCP) server that offers onchain tools for AI applications such as Claude Code and Cursor, enabling them to effortlessly build components for receiving and making payments using cryptocurrency.

🚀 Quick Start

The Payment-MCP is a Model Context Protocol (MCP) server that offers onchain tools for AI applications. To start using it, follow the steps in the "Setup" section below.

✨ Features

• Create Payment Requests: Generate payment requests with specified amounts and currencies.
• Check Payment Status: Monitor the status of payment requests.
• Make Payments: Initiate cryptocurrency payments to specified addresses.
• Wallet Management: Retrieve wallet addresses for different cryptocurrencies.

📦 Installation

Prerequisites

• Node.js >= 18.0.0
• npm or yarn

Installation Steps

1. Install dependencies:

npm install

2. Build the project:

npm run build

Development

Run in development mode with hot reload:

npm run dev

Usage

Start the MCP server:

npm start

💻 Usage Examples

Basic Usage

To start the server, run the following command:

npm start

Advanced Usage

You can use the available tools provided by the server. For example, to create a payment request:

# Assume you have a proper environment to call the API
# Here is a pseudo - code example
# Replace the parameters with actual values
curl -X POST -H "Content-Type: application/json" -d '{"amount": 100, "currency": "ETH", "description": "Test payment"}' http://localhost:3000/create_payment_request

📚 Documentation

Available Tools

create_payment_request

Create a new payment request with a specified amount and currency.

Parameters:

• amount (number): The amount to request.
• currency (string): Cryptocurrency symbol (ETH, USDC, USDT).
• description (string, optional): Description of the payment request.

check_payment_status

Check the status of a payment request by its ID.

Parameters:

• paymentRequestId (string): The ID of the payment request.

make_payment

Initiate a cryptocurrency payment to a specified address.

Parameters:

• to (string): Recipient's cryptocurrency address.
• amount (number): Amount to send.
• currency (string): Cryptocurrency symbol (ETH, USDC, USDT).

get_wallet_address

Get the wallet address for a specific cryptocurrency.

Parameters:

• currency (string): Cryptocurrency symbol (ETH, USDC, USDT).

🔧 Technical Details

Project Structure

Payment-MCP/
├── src/
│   ├── index.ts              # Main server entry point
│   └── handlers/
│       └── payment.ts        # Payment tool handlers
├── dist/                     # Compiled output (generated)
├── package.json
├── tsconfig.json
└── README.md

⚠️ Important Note

This is an early version. The payment functionality currently returns mock data. Integration with actual blockchain services and payment providers is pending implementation.

📄 License

GPL - 3.0