{"_id":"@payaion/mcp","_rev":"6-1a87b99166a2cbef6a6203b2b2cfd5f2","name":"@payaion/mcp","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.0":{"name":"@payaion/mcp","version":"1.0.0","keywords":["mcp","mcp-server","payaion","ai-agents","file-upload","file-transfer","marketplace","payments","usdc","base","x402","claude","cursor"],"license":"MIT","_id":"@payaion/mcp@1.0.0","maintainers":[{"name":"defdone","email":"jan@defdone.com"}],"homepage":"https://payaion.com","bin":{"payaion-mcp":"dist/stdio.js"},"dist":{"shasum":"df6d2cd9cce6cce8c5e4e24d39d8c4979d2c3ca6","tarball":"https://registry.npmjs.org/@payaion/mcp/-/mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-GkvL8hGg705gQ0GuPSjTpGlbhyf8+18pUgC4X2hGJfMZzR/nWp4OhUSxzyPLqZuddkaUqObtSjpcIX6EtdjYKg==","signatures":[{"sig":"MEUCIAZeQKJUUJpCuRD2DpjpADyZEqMMsQ+qbh99e9mR/Km1AiEA7F8EfudqRdCRRsCuMSRG9ZZFUdSe161rzqIoCnN3wiQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":488113},"type":"module","engines":{"node":">=20"},"gitHead":"092e4c4368baf0be70035a52b8d20a5ee527f63f","scripts":{"dev":"tsx watch --env-file=.env src/index.ts","build":"node build.mjs","start":"node dist/index.js","dev:stdio":"tsx --env-file=.env src/stdio.ts","typecheck":"tsc --noEmit","start:stdio":"node dist/stdio.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"defdone","email":"jan@defdone.com"},"_npmVersion":"11.18.0","description":"MCP server for Payaion — file uploads, marketplace listings, and paid downloads for AI agents on Base mainnet (USDC).","directories":{},"_nodeVersion":"24.2.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","zod":"^3.25.0","esbuild":"^0.27.3","express":"^5.1.0","typescript":"^5","@types/express":"^5.0.0","@modelcontextprotocol/sdk":"^1.27.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.0_1785251295765_0.9336342471214318","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@payaion/mcp","version":"1.0.1","keywords":["mcp","mcp-server","payaion","ai-agents","file-upload","file-transfer","marketplace","payments","usdc","base","x402","claude","cursor"],"license":"MIT","_id":"@payaion/mcp@1.0.1","maintainers":[{"name":"defdone","email":"jan@defdone.com"}],"homepage":"https://payaion.com","bin":{"payaion-mcp":"dist/stdio.js"},"dist":{"shasum":"f30a3726866a1e3b4950226a2547e06e573cad81","tarball":"https://registry.npmjs.org/@payaion/mcp/-/mcp-1.0.1.tgz","fileCount":4,"integrity":"sha512-1Uadh8jdp7hAv28yIQ35J7GRSHwnrqv3dCvW1vV8/rvTTg4s2A3d89kf+VCgzFqxTL+J/ia59rzuUwqRptkXPw==","signatures":[{"sig":"MEUCIHvJEslsXUqJIxt9fXylWUmAmGTXwuKv3B+5xmZ44oF5AiEA5nyfjxFYO8kFwnJKmp3iunPikUFdoOxhVZbfFh6bMig=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":488136},"type":"module","engines":{"node":">=20"},"gitHead":"d78cc71437cd43b258a747f54302eeac4c6645c5","scripts":{"dev":"tsx watch --env-file=.env src/index.ts","build":"node build.mjs","start":"node dist/index.js","dev:stdio":"tsx --env-file=.env src/stdio.ts","typecheck":"tsc --noEmit","start:stdio":"node dist/stdio.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"defdone","email":"jan@defdone.com"},"_npmVersion":"11.18.0","description":"MCP server for Payaion — file uploads, marketplace listings, and paid downloads for AI agents on Base mainnet (USDC).","directories":{},"_nodeVersion":"24.2.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","zod":"^3.25.0","esbuild":"^0.27.3","express":"^5.1.0","typescript":"^5","@types/express":"^5.0.0","@modelcontextprotocol/sdk":"^1.27.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.1_1785259349340_0.010221742881107998","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@payaion/mcp","version":"1.0.2","keywords":["mcp","mcp-server","payaion","ai-agents","file-upload","file-transfer","marketplace","payments","usdc","base","x402","claude","cursor"],"license":"MIT","_id":"@payaion/mcp@1.0.2","maintainers":[{"name":"defdone","email":"jan@defdone.com"}],"homepage":"https://payaion.com","bin":{"payaion-mcp":"dist/stdio.js"},"dist":{"shasum":"eb6e6d32af06ce1f4cde573ead56b667f3b00243","tarball":"https://registry.npmjs.org/@payaion/mcp/-/mcp-1.0.2.tgz","fileCount":4,"integrity":"sha512-FGVhoPXGmJdUtmiA+ANTAsxsw68tJYePeMjmF6w1s7U1fDudwlknM9nX2PJjqz7KciF7jRBMNdGrJztMOgaJbw==","signatures":[{"sig":"MEUCIFfG6lHgsKMJns5pDHRK21VRjSR8wuUVzP2keo1zSzUuAiEAzE/y5joT+g0jd8RWsPENttCLKvOBGxR2/991NNVdBQU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":488282},"type":"module","engines":{"node":">=20"},"gitHead":"e4307e5e2d13450c483064767f6a29f295744a6b","scripts":{"dev":"tsx watch --env-file=.env src/index.ts","build":"node build.mjs","start":"node dist/index.js","dev:stdio":"tsx --env-file=.env src/stdio.ts","typecheck":"tsc --noEmit","start:stdio":"node dist/stdio.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"defdone","email":"jan@defdone.com"},"_npmVersion":"11.18.0","description":"MCP server for Payaion — file uploads, marketplace listings, and paid downloads for AI agents on Base mainnet (USDC).","directories":{},"_nodeVersion":"24.2.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","zod":"^3.25.0","esbuild":"^0.27.3","express":"^5.1.0","typescript":"^5","@types/express":"^5.0.0","@modelcontextprotocol/sdk":"^1.27.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.2_1785746982347_0.2293450683424758","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@payaion/mcp","version":"1.0.3","keywords":["mcp","mcp-server","payaion","ai-agents","file-upload","file-transfer","marketplace","payments","usdc","base","x402","claude","cursor"],"license":"MIT","_id":"@payaion/mcp@1.0.3","maintainers":[{"name":"defdone","email":"jan@defdone.com"}],"homepage":"https://payaion.com","bugs":{"email":"contact@payaion.com"},"bin":{"payaion-mcp":"dist/stdio.js"},"dist":{"shasum":"5aea40f93bc83f2d2d7547d572fe81f31bf47764","tarball":"https://registry.npmjs.org/@payaion/mcp/-/mcp-1.0.3.tgz","fileCount":4,"integrity":"sha512-I3kYf6nAgqFPvdxb8zP6PzBWNa7/8IjSHyYEWT8sN9ruezSTNll0iXdO3kc7dshS3xqvX8QQgPCIKKWN0xe+sg==","signatures":[{"sig":"MEUCICJk3K6PF+ZQ3ddVfVlIzDMP3XY7pqN4LfVJeL7sKEHmAiEA7qFD7oNNtBQr8Chwet3RDO/hq4vtqiLTr5a8SIuOe1g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":489143},"type":"module","engines":{"node":">=20"},"gitHead":"4d854e7157d8ed1bd3764665b76526421167a316","scripts":{"dev":"tsx watch --env-file=.env src/index.ts","test":"tsx scripts/check-no-key-startup.ts","build":"node build.mjs","start":"node dist/index.js","dev:stdio":"tsx --env-file=.env src/stdio.ts","typecheck":"tsc --noEmit","start:stdio":"node dist/stdio.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"defdone","email":"jan@defdone.com"},"_npmVersion":"11.18.0","description":"MCP server for Payaion — file uploads, marketplace listings, and paid downloads for AI agents on Base mainnet (USDC).","directories":{},"_nodeVersion":"24.2.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","zod":"^3.25.0","esbuild":"^0.27.3","express":"^5.1.0","typescript":"^5","@types/express":"^5.0.0","@modelcontextprotocol/sdk":"^1.27.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.3_1785961296030_0.7025767590228427","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@payaion/mcp","version":"1.0.4","keywords":["mcp","mcp-server","payaion","ai-agents","file-upload","file-transfer","marketplace","payments","usdc","base","x402","claude","cursor"],"license":"MIT","_id":"@payaion/mcp@1.0.4","maintainers":[{"name":"defdone","email":"jan@defdone.com"}],"homepage":"https://payaion.com","bugs":{"email":"contact@payaion.com"},"bin":{"payaion-mcp":"dist/stdio.js"},"dist":{"shasum":"8552de2b1a8a2c22f96951d0e24f7f6217ce3698","tarball":"https://registry.npmjs.org/@payaion/mcp/-/mcp-1.0.4.tgz","fileCount":4,"integrity":"sha512-nhV3qovrWE/uemCyzFmYdUmscTKzCGgFhjHdiGcHuCba9wODY0oM91IHz8nGEDAUnZY9hzSaRd0l/fMB7ek0ag==","signatures":[{"sig":"MEYCIQD5uijtCzAN0QMfGZnn96orUegNbz2mVm72+lSB5KiYyAIhAImY/Y1W7iNF0QNxbrHTymMf/PFmHnVTBvwi19owQGxz","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":489184},"type":"module","engines":{"node":">=20"},"gitHead":"42d5ca7f91737d35d8bdcb46cb0f3ca497ac09b6","mcpName":"com.payaion/mcp","scripts":{"dev":"tsx watch --env-file=.env src/index.ts","test":"tsx scripts/check-no-key-startup.ts","build":"node build.mjs","start":"node dist/index.js","dev:stdio":"tsx --env-file=.env src/stdio.ts","typecheck":"tsc --noEmit","start:stdio":"node dist/stdio.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"defdone","email":"jan@defdone.com"},"_npmVersion":"11.18.0","description":"MCP server for Payaion — file uploads, marketplace listings, and paid downloads for AI agents on Base mainnet (USDC).","directories":{},"_nodeVersion":"24.2.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","zod":"^3.25.0","esbuild":"^0.27.3","express":"^5.1.0","typescript":"^5","@types/express":"^5.0.0","@modelcontextprotocol/sdk":"^1.27.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.4_1786017679381_0.14349003380774783","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@payaion/mcp","version":"1.0.5","mcpName":"io.github.defdone/payaion","publishConfig":{"access":"public"},"description":"MCP server for Payaion — file uploads, marketplace listings, and paid downloads for AI agents on Base mainnet (USDC).","keywords":["mcp","mcp-server","payaion","ai-agents","file-upload","file-transfer","marketplace","payments","usdc","base","x402","claude","cursor"],"type":"module","license":"MIT","homepage":"https://payaion.com","bugs":{"email":"contact@payaion.com"},"bin":{"payaion-mcp":"dist/stdio.js"},"engines":{"node":">=20"},"scripts":{"dev":"tsx watch --env-file=.env src/index.ts","dev:stdio":"tsx --env-file=.env src/stdio.ts","build":"node build.mjs","typecheck":"tsc --noEmit","test":"tsx scripts/check-no-key-startup.ts","start":"node dist/index.js","start:stdio":"node dist/stdio.js","prepublishOnly":"npm run build"},"devDependencies":{"@modelcontextprotocol/sdk":"^1.27.0","@types/express":"^5.0.0","esbuild":"^0.27.3","express":"^5.1.0","tsx":"^4.21.0","typescript":"^5","zod":"^3.25.0"},"gitHead":"77b65d113e645dba74ec13d07e594d54722a0e38","_id":"@payaion/mcp@1.0.5","_nodeVersion":"24.2.0","_npmVersion":"11.18.0","dist":{"integrity":"sha512-6p0TbAYXEbCkvp7AIWVI7+asT4hgyZPf5Czpir5MF/5Ws1Juh9ixRwaWy8IcDgsiF9iI7JgLi6hizM/qCZ0Qsw==","shasum":"2f62927b39157b3efc592179625d3e7ccc198b07","tarball":"https://registry.npmjs.org/@payaion/mcp/-/mcp-1.0.5.tgz","fileCount":4,"unpackedSize":489194,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIQCFdyP5ynb4IjfzTmfx+9bj5DMCzu3ZLTD0Wt7f4a3OPAIfcssShFBum4lRLrMsNICGZcuvkqVuGybqWdYQqafpvw=="}]},"_npmUser":{"name":"defdone","email":"jan@defdone.com"},"directories":{},"maintainers":[{"name":"defdone","email":"jan@defdone.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.0.5_1786021140737_0.3001867208257445"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-28T15:08:15.619Z","modified":"2026-08-06T12:59:01.072Z","1.0.0":"2026-07-28T15:08:15.957Z","1.0.1":"2026-07-28T17:22:29.533Z","1.0.2":"2026-08-03T08:49:42.497Z","1.0.3":"2026-08-05T20:21:36.246Z","1.0.4":"2026-08-06T12:01:19.566Z","1.0.5":"2026-08-06T12:59:00.887Z"},"bugs":{"email":"contact@payaion.com"},"license":"MIT","homepage":"https://payaion.com","keywords":["mcp","mcp-server","payaion","ai-agents","file-upload","file-transfer","marketplace","payments","usdc","base","x402","claude","cursor"],"description":"MCP server for Payaion — file uploads, marketplace listings, and paid downloads for AI agents on Base mainnet (USDC).","maintainers":[{"name":"defdone","email":"jan@defdone.com"}],"readme":"# @payaion/mcp\n\nMCP server for [Payaion](https://payaion.com) — file uploads, marketplace listings, and paid downloads for AI agents on **Base mainnet** (USDC).\n\n## Quick Start\n\nNo API key needed to start. Add the server and the transfer tools work\nimmediately — uploads run as a guest: 100 MB per file, 24-hour link.\n\n```json\n{\n  \"mcpServers\": {\n    \"payaion\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@payaion/mcp\"]\n    }\n  }\n}\n```\n\nRestart your MCP client (Cursor, Claude Desktop, …) and ask it to transfer a file.\n\n### Adding a key\n\nA key raises the limits (500 MB per file, 2 GB stored, 30-day links) and is\nrequired to sell. Two ways to get one:\n\n- **From the dashboard** — connect a wallet at\n  [payaion.com/dashboard](https://payaion.com/dashboard).\n- **From the agent itself** — sign a message with a wallet it holds locally, no\n  browser involved. Three requests, documented at\n  [payaion.com/docs/agent-flow](https://payaion.com/docs/agent-flow).\n\n```json\n{\n  \"mcpServers\": {\n    \"payaion\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@payaion/mcp\"],\n      \"env\": { \"PAYAION_API_KEY\": \"av_…\" }\n    }\n  }\n}\n```\n\nKeys minted by signature carry upload scopes only. Pricing a file for sale stays\na human action in the dashboard, and earnings go to a payout address that no API\nkey can read or change — set it under Earnings and use a cold wallet.\n\n## Available Tools\n\n| Tool                       | Description                                                                      |\n| -------------------------- | -------------------------------------------------------------------------------- |\n| `transfer`                 | One-shot file transfer with optional pricing & marketplace listing (recommended) |\n| `upload_file`              | Upload a local file or base64 content (returns upload ID)                        |\n| `upload_from_url`          | Upload a file from a public URL                                                  |\n| `get_upload_status`        | Check the processing status of an upload                                         |\n| `get_download_url`         | Get a fresh shareable download URL for a completed upload                        |\n| `list_on_marketplace`      | List an uploaded file on the public Payaion marketplace                          |\n| `browse_marketplace`       | Search and browse active marketplace listings                                    |\n| `get_payment_requirements` | Fetch price and payment terms for a listing before buying                        |\n| `purchase_asset`           | Finalize the purchase of a paid listing (real USDC)                              |\n\nEverything above the line works without a key. `list_on_marketplace`,\n`get_payment_requirements` and `purchase_asset` move money and require one.\n\nA keyless caller is identified by a hash of its IP, so an agent that changes\nnetwork loses `get_upload_status` and `get_download_url` for its earlier\nuploads. The share link keeps working — it belongs to the file, not the caller.\nKeep the `downloadUrl` from the upload response and nothing is lost.\n\n### Upload Methods\n\nEach upload tool supports three mutually exclusive input methods:\n\n- **`filePath`** — Local file path (stdio only, most efficient — zero tokens)\n- **`url`** — Public URL for the server to fetch\n- **`content`** — Base64-encoded file content (fallback)\n\n### Pricing & Marketplace\n\n```yaml\npricePerDownload: 0.50  # USD, charged in USDC on Base\n```\n\nTo list on the marketplace, use `transfer` with listing metadata:\n\n```yaml\nlistingTitle: \"Dataset Q1 2026\"        # 3–120 chars\nlistingDescription: \"Cleaned Q1 2026 sales data — deduplicated, currency-normalised, with a column dictionary.\"\nlistingCategory: \"datasets\"            # reports | datasets | code | media | models | prompts | other\nlistingTags: [\"sales\", \"q1\"]           # max 8, alphanumeric + hyphens\n```\n\n`listingDescription` must be 40–500 characters — shorter descriptions are rejected.\nA price above 0 requires a wallet connected to your account.\n\nOr list separately after upload with `list_on_marketplace`.\n\n### Browsing the Marketplace\n\n```yaml\nq: \"oil analysis\"\ncategory: \"reports\"\npage: 1\npageSize: 20\n```\n\nAll URLs returned use the unified `/d/{hash}` page.\n\n## Environment Variables\n\n| Variable               | Required | Default                       | Description                                     |\n| ---------------------- | -------- | ----------------------------- | ----------------------------------------------- |\n| `PAYAION_API_KEY`      | No       | —                             | Raises limits and enables selling. Without it you upload as a guest |\n| `PAYAION_API_BASE_URL` | No       | `https://payaion-api.fly.dev` | Payaion API endpoint — leave unset in normal use |\n\n## Limits\n\nEnforced per request against the account's current plan, so an expired Pro is back\non Basic limits immediately.\n\n| | Guest (no key) | Basic | Pro |\n| --- | --- | --- | --- |\n| Per file | 100 MB | 500 MB | 1 GB |\n| Total storage | — (per-file only) | 2 GB | 20 GB |\n| Link lifetime | 24 hours | 30 days | while subscribed |\n| Live files | — | 200 | 2,000 |\n| Marketplace / day | cannot sell | 5 list · 10 buy | 50 list · 100 buy |\n\nUploads are capped at 5/min with 2 in flight. Exceeding a size or storage limit is a\nfinal answer — retrying or splitting the file will not get around it.\n\n## Supported Clients\n\nAny MCP client that supports stdio transport:\n\n- [Cursor](https://cursor.sh)\n- [Claude Desktop](https://claude.ai/download)\n- [Cline](https://github.com/clinebot/cline)\n- [Continue](https://continue.dev)\n\n## CLI\n\n```bash\nnpx @payaion/mcp --help\nnpx @payaion/mcp --version\n```\n\n## Also Available\n\n- **Python:** `pip install payaion-mcp` ([PyPI](https://pypi.org/project/payaion-mcp/))\n- **Docs:** [payaion.com/docs](https://payaion.com/docs)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}