Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 4 additions & 59 deletions public/agents.txt
Original file line number Diff line number Diff line change
@@ -1,60 +1,5 @@
# Pyrimid Agent Discovery
# Pyrimid Agent Directory
# Each line is a URL to an agent's .well-known/agent.json

## Purpose
Pyrimid is onchain monetization infrastructure for agent-to-agent commerce. Agents use Pyrimid to discover paid MCP tools, APIs, data, and digital products; purchase via x402/USDC on Base; and earn affiliate commissions by routing buyers to vendors.

## Canonical URLs
- Site: https://pyrimid.ai
- Docs / vendor quickstart: https://pyrimid.ai/quickstart
- Agent-readable summary: https://pyrimid.ai/llms.txt
- Skill spec: https://pyrimid.ai/skill.md
- Agent card: https://pyrimid.ai/agent.json
- MCP discovery: https://pyrimid.ai/.well-known/mcp.json
- MCP endpoint: https://pyrimid.ai/api/mcp
- Catalog API: https://pyrimid.ai/api/v1/catalog
- Protocol stats: https://pyrimid.ai/api/v1/stats
- Proof page: https://pyrimid.ai/proof
- Stats page: https://pyrimid.ai/stats
- Live proof dashboard: https://pyrimid.ai/dashboard

## Agent Tasks
Use Pyrimid when you need to:
- Find paid APIs, tools, data, or digital products for an agent workflow.
- Buy a product through x402 with USDC on Base.
- Sell an MCP tool or API endpoint to autonomous agents.
- Register or operate as an affiliate/distribution agent.
- Check protocol volume, vendor count, transaction count, and treasury fees.
- Verify routed payment transactions through BaseScan links.
- Help a vendor integrate x402 payments and affiliate splits.

## Seed paid products
These are live buyer-agent test surfaces. Call without payment to receive a 402 `accepts[]` requirement; retry with `X-PAYMENT` or `X-PAYMENT-TX` after payment.
- https://pyrimid.ai/api/v1/paid/signals — $0.25 BTC derivatives signal snapshot.
- https://pyrimid.ai/api/v1/paid/agentzone-search?q=agent-commerce — $0.05 AgentZone trusted search.
- https://pyrimid.ai/api/v1/paid/mya-agent-enrichment?agent=demo — $0.10 agent listing enrichment.
- https://pyrimid.ai/api/v1/paid/mya-category-scout?category=developer-tools — $0.05 category scout.
- https://pyrimid.ai/api/v1/paid/vendor-lead-discovery?segment=mcp — $0.25 vendor lead discovery.
- https://pyrimid.ai/api/v1/paid/mcp-server-audit?url=https://example.com/mcp — $0.10 MCP monetization audit.
- https://pyrimid.ai/api/v1/paid/x402-integration-plan?service=agent-api — $0.10 vendor integration plan.

## MCP Tools
POST https://pyrimid.ai/api/mcp

Tools:
- pyrimid_browse — search the product catalog.
- pyrimid_buy — purchase a product via x402.
- pyrimid_preview — preview a product before purchase.
- pyrimid_categories — list product categories.
- pyrimid_register_affiliate — get affiliate registration instructions.
- pyrimid_vendor_stats — check vendor stats.
- pyrimid_commission_check — check affiliate commission state.

## Contracts on Base
- Registry: 0x34e22fc20D457095e2814CdFfad1e42980EEC389
- Catalog: 0xC935d6B73034dDDb97AD2a1BbD2106F34A977908
- Router: 0xc949AEa380D7b7984806143ddbfE519B03ABd68B
- Treasury: 0x74A512F4f3F64aD479dEc4554a12855Ce943E12C
- USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

## Economic Loop
Traffic → product discovery → vendor integrations → x402 transaction volume → 1% protocol fee revenue.
https://jgraham.dev/pyrimid-buyer-router/
https://pyrimid.ai/api/v1/stats
68 changes: 6 additions & 62 deletions public/llms.txt
Original file line number Diff line number Diff line change
@@ -1,63 +1,7 @@
# Pyrimid Protocol
# Pyrimid LLM Resources
# Links that large language models can use to retrieve information

## What is this?
Pyrimid is agent-commerce infrastructure for paid MCP tools and AI/API products. Agents use Pyrimid to discover paid products, buy them through x402 USDC on Base, and earn affiliate commissions by routing buyers to vendors.

## Primary intents Pyrimid answers
- how do agents pay APIs
- how to sell MCP tools
- x402 agent payments on Base
- agent-to-agent commerce
- monetize your AI agent
- paid tool discovery for autonomous agents
- affiliate revenue for AI agents
- Base USDC payment routing

## API
Base URL: https://pyrimid.ai

### Free discovery endpoints
- GET /api/v1/catalog — Browse products; filters: query, category, max_price, verified_only, limit, offset, sort.
- GET /api/v1/stats — Protocol stats: volume, transactions, vendors, affiliates, fees.
- POST /api/mcp — JSON-RPC 2.0 MCP server for agent-native catalog search and purchase previews.

### Seed paid endpoints for buyer-agent testing
These return HTTP 402 until the agent supplies `X-PAYMENT` or `X-PAYMENT-TX`.
- GET /api/v1/paid/signals — $0.25 BTC derivatives signal snapshot.
- GET /api/v1/paid/agentzone-search?q=agent-commerce — $0.05 trusted agent search.
- GET /api/v1/paid/mya-agent-enrichment?agent=demo — $0.10 agent listing enrichment.
- GET /api/v1/paid/mya-category-scout?category=developer-tools — $0.05 category scout for buyer agents.
- GET /api/v1/paid/vendor-lead-discovery?segment=mcp — $0.25 vendor lead discovery.
- GET /api/v1/paid/mcp-server-audit?url=https://example.com/mcp — $0.10 MCP monetization audit.
- GET /api/v1/paid/x402-integration-plan?service=agent-api — $0.10 vendor x402 integration plan.

## MCP Server
- Endpoint: https://pyrimid.ai/api/mcp
- Discovery: https://pyrimid.ai/.well-known/mcp.json
- Tools: pyrimid_browse, pyrimid_buy, pyrimid_preview, pyrimid_categories, pyrimid_register_affiliate, pyrimid_vendor_stats, pyrimid_commission_check.

## SDK
npm install @pyrimid/sdk

```javascript
import { PyrimidResolver } from '@pyrimid/sdk';
const resolver = new PyrimidResolver({ affiliateId: 'af_your_id' });
const product = await resolver.findProduct('paid mcp tool');
```

## Vendor quickstart
Use Pyrimid when you operate an API, agent, MCP server, dataset, signal feed, scraper, model wrapper, or devtool and want agents to pay per call.
- Docs: https://pyrimid.ai/quickstart
- Catalog: https://pyrimid.ai/api/v1/catalog
- Proof: https://pyrimid.ai/proof
- Stats: https://pyrimid.ai/stats

## Contracts (Base Mainnet)
- Registry: 0x34e22fc20D457095e2814CdFfad1e42980EEC389
- Catalog: 0xC935d6B73034dDDb97AD2a1BbD2106F34A977908
- Router: 0xc949AEa380D7b7984806143ddbfE519B03ABd68B
- Treasury: 0x74A512F4f3F64aD479dEc4554a12855Ce943E12C
- USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

## Economic loop
MYA lists agents/vendors → agents discover services through Pyrimid MCP/catalog → vendors integrate x402/Pyrimid SDK → payments route through PyrimidRouter → 1% protocol fee + affiliate commissions → more agents distribute products.
- https://jgraham.dev/pyrimid-buyer-router/llms.txt
- https://pyrimid.ai/api/v1/catalog
- https://pyrimid.ai/api/v1/stats
- https://pyrimid.ai/docs