CosmosPay/CosmosPay-MCP

An MCP server for the Cosmos Pay Payments API. It lets an AI agent (Claude Code, Claude Desktop, Cursor, VS Code, Windsurf and any other MCP client) create stablecoin payment links and check payments on Stellar, Solana and Monad with your API key.
Cosmos Pay is non-custodial: a payment link is a request the customer pays from their own wallet, and the money settles on-chain straight to your address. Nothing in this server signs or moves funds.
Cosmos Pay (cosmospay.lat) is a different project from the Cosmos Network (ATOM).
## Tools
| Tool | What it does | Kind |
| createpaymentlink | Create a payment request: a link (SEP-7 on Stellar, Solana Pay on Solana, EIP-681 on Monad), its QR code and a hosted checkout page | creates, moves no money |
| getpayment | One payment: status, amount, asset, chain, link, checkout URL and, once paid, the transaction hash | read |
| getpaymenthistory | A payment's status changes | read |
| listpayments | Payments, newest first, filtered by status, chain or date, paged | read |
| validatepayment | Check a transaction hash against a payment and settle it if it pays it | idempotent |
| deletepayment | Delete an unpaid payment so its link can no longer be paid | destructive |
| getsummary | Totals, settled volume, webhook health and a 30-day series | read |
| getbalances | Settled and pending amounts per asset | read |
| liststellarassets | Stellar asset codes and issuers to charge in (USDC, EURC...) | read |
Each tool carries MCP annotations (readOnlyHint, destructiveHint), so your client can ask before anything that writes.
## Setup
1. Create a secret API key in the Cosmos Pay dashboard (API keys). Start with a dv key: it works on test networks with no real money. A prod key works on mainnet.
2. Add the server to your MCP client with the key in its environment.
Claude Code
bash
claude mcp add cosmos-pay --env COSMOSPAYAPIKEY=dvyourkey -- npx -y @cosmosapp/paymcp
Claude Desktop, Cursor, Windsurf (claudedesktopconfig.json, .cursor/mcp.json, ~/.codeium/windsurf/mcpconfig.json)
json
"mcpServers": {
"cosmos-pay": {
"command": "npx",
"args": ["-y", "@cosmosapp/paymcp"],
"env": { "COSMOSPAYAPIKEY": "dvyourkey" }
VS Code (.vscode/mcp.json)
json
"inputs": [{ "type": "promptString", "id": "cosmos-pay-key", "description": "Cosmos Pay API key", "password": true }],
"servers": {
"cosmos-pay": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@cosmosapp/paymcp"],
"env": { "COSMOSPAYAPIKEY": "${input:cosmos-pay-key}" }
Then ask your agent things like "Create a payment link for 25 USDC on Stellar to my store's address" or "Which payments from this week are still pending?"
## Configuration
| Variable | |
| COSMOSPAYAPIKEY | Required. A secret key from the dashboard: dv test networks, prod mainnet. |
| COSMOSPAYREADONLY | 1 offers only the tools that read (no create, validate or delete). |