Pyrimid Protocol — Claude Code MCP server: paid MCP tools and x402
An MCP server for agent commerce: browse paid MCP tools and AI APIs, buy them over x402, and settle affiliate commissions in USDC on Base.
claude mcp add --transport http pyrimid https://pyrimid.ai/api/mcpWhat Pyrimid Protocol does
Pyrimid Protocol links three sides — vendors list paid MCP tools and AI APIs, agents find and buy them over x402, and smart contracts on Base settle commissions in USDC. Agents get pyrimid_browse to search the catalog, pyrimid_preview to see the commission split before paying, and pyrimid_buy to complete a purchase with affiliate attribution.
The split works like this: 1% goes to the protocol treasury, the affiliate gets 0–50% depending on the rate the vendor sets, and the vendor keeps the rest. With no affiliate, the vendor receives 99%. Registry, Catalog, Router and Treasury contracts are deployed and verified on Base Mainnet using the ERC-1967 proxy pattern.
Read access to the API is free and rate-limited to 60 requests per minute. Paid endpoints such as /api/v1/paid/signals answer with HTTP 402 and x402 accepts[] metadata first; you retry with an X-PAYMENT or X-PAYMENT-TX header. No Base wallet and no working x402 payment means pyrimid_buy goes nowhere.
What it helps with
- find a paid MCP tool for a specific job
- check the commission split before paying
- buy an API endpoint over x402 with affiliate attribution
- register as an affiliate and earn USDC commissions
- list your own API with a price and affiliate rate
Example prompts for the agent
- Search the Pyrimid catalog for trading signal tools and show me the prices
- Preview the commission split for
signals_latestbefore I buy - Buy
/api/v1/paid/agentzone-search?q=agent-commerceover x402
How to install Pyrimid Protocol
Platform CLI: remote server
claude mcp add --transport http pyrimid https://pyrimid.ai/api/mcpPlatform CLI: remote server
codex mcp add pyrimid-protocol --url https://pyrimid.ai/api/mcpConfig file
{
"mcpServers": {
"pyrimid-protocol": {
"url": "https://pyrimid.ai/api/mcp"
}
}
}Config file
{
"servers": {
"pyrimid-protocol": {
"type": "http",
"url": "https://pyrimid.ai/api/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http pyrimid-protocol https://pyrimid.ai/api/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Pyrimid Protocol
How do I install Pyrimid Protocol in Claude Code?
Run claude mcp add --transport http pyrimid https://pyrimid.ai/api/mcp to connect the server over Streamable HTTP.
What does Pyrimid Protocol do?
It gives an agent a catalog of paid MCP tools and AI APIs: search, commission preview, and purchase over x402 with USDC settlement on Base.
What do I need before buying through Pyrimid?
A Base wallet and an x402 payment. A paid endpoint returns HTTP 402 first, and the retry must carry an X-PAYMENT or X-PAYMENT-TX header.
