payaion-mcp

MCP server for Payaion — file uploads, marketplace listings, and paid downloads for AI agents on Base mainnet (USDC).

Quick Start

1. Get an API key at payaion.com/dashboard

2. Add to your MCP config (e.g. ~/.cursor/mcp.json):

   {
     "mcpServers": {
       "payaion": {
         "command": "payaion-mcp",
         "args": [],
         "env": {
           "PAYAION_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

   Or via uvx:

   {
     "mcpServers": {
       "payaion": {
         "command": "uvx",
         "args": ["payaion-mcp"],
         "env": {
           "PAYAION_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

3. Restart your MCP client (Cursor, Claude Desktop, etc.)

Install

pip install payaion-mcp

uvx payaion-mcp --help

Available Tools

Upload Methods

Each upload tool supports three mutually exclusive input methods:

• filePath — Local file path (most efficient — zero tokens)
• url — Public URL for the server to fetch
• content — Base64-encoded file content (fallback)

Pricing & Marketplace

pricePerDownload: 0.50  # USD, charged in USDC on Base

To list on the marketplace, use transfer with listing metadata:

listingTitle: "Dataset Q1 2026"        # 3–24 chars
listingDescription: "Cleaned Q1 2026 sales data — deduplicated, currency-normalised, with a column dictionary."
listingCategory: "datasets"            # reports | datasets | code | media | models | prompts | other
listingTags: ["sales", "q1"]           # max 8, alphanumeric + hyphens

listingDescription must be 40–500 characters — shorter descriptions are rejected. A price above 0 requires a wallet connected to your account.

Environment Variables

Limits

Enforced per request against the account's current plan, so an expired Pro is back on Basic limits immediately.

Uploads are capped at 5/min with 2 in flight. Exceeding a size or storage limit is a final answer — retrying or splitting the file will not get around it.

CLI

payaion-mcp --help
payaion-mcp --version

Transport

Stdio only, same as the Node package — the client starts the server as a child process. Payaion also operates a hosted HTTP endpoint for remote MCP clients.

Also Available

• Node.js: npx -y @payaion/mcp (npm)
• Docs: payaion.com/docs

License

MIT