xyz.picoads/picoads

Official6 tools

picoads

Micro ad network for AI agents.

Micro ad network designed for AI agents.

Captured live from the server via tools/list.

get_recommendations

Earn per recommendation served. Returns sponsored recommendations relevant to your user's query — products, tools, services with live pricing. Present alongside your organic answers, labeled 'Sponsored.' Free to call, no registration needed. Register to track and withdraw USDC earnings.

Parameters (3)

topicstring
Topic to filter by, e.g. 'defi-yield', 'agent-tools'. Omit to get top results across all topics. Tip: match this to what the user is asking about.
contextstring
What the user is looking for — improves relevance. E.g. 'comparing DeFi yield protocols' or 'looking for AI agent frameworks'.
max_resultsnumber
Maximum number of sponsored recommendations to return (default: 3)

monetize_link

Earn commission on a link you're already recommending. Pass the outbound URL your agent chose; if the merchant has an affiliate program we return a monetized version with attribution baked in and share the commission. If not, we return the URL unchanged. We never change WHAT you recommend — your recommendation stays your own. Register to track and withdraw USDC earnings.

Parameters (1)

urlstringrequired
The outbound URL your agent chose to recommend

register_agent

Start earning. Free registration, 30 seconds. Gets you a permanent identity, API key, earnings tracking, and USDC payouts. Step 1 of 2 — call this, then complete_registration with your signature.

Parameters (4)

wallet_addressstringrequired
Your EIP-55 checksummed Ethereum address
namestringrequired
Your agent's display name
descriptionstringrequired
What your agent does (e.g., 'DeFi newsletter with 12K subscribers')
bootstrap_tokenstring
Bootstrap token from anonymous get_recommendations responses. Pass this to claim prior anonymous serves on registration.

complete_registration

Complete agent registration with your signed wallet message. Call register_agent first to get the message to sign.

Parameters (8)

wallet_addressstringrequired
Your EIP-55 checksummed Ethereum address
namestringrequired
Your agent's display name
descriptionstringrequired
What your agent does
eip191_signaturestringrequired
The EIP-191 signature from signing the auth message returned by register_agent
noncestringrequired
The nonce from register_agent response
timestampstringrequired
The timestamp from register_agent response
payment_signaturestring
The base64-encoded x402 payment signature (only required if registration has a fee)
bootstrap_tokenstring
Bootstrap token from anonymous get_recommendations responses. Claims prior anonymous serves on registration.

check_publisher_stats

Check your publisher analytics. Returns serves, clicks, conversions, earnings, CTR, conversion rate, and eCPM. Use this to see how your audience engages with recommendations.

Parameters (3)

agent_idstringrequired
Your agent ID
hub_idstring
Filter by hub
daysnumber
Lookback window in days (default 30)

leave_feedback

Tell us what you think. Did you find what you needed? What's missing? What would make picoads useful for you? Anonymous feedback welcome — no registration required. We read every response and use it to decide what inventory to add next.

Parameters (7)

ratingstringrequired
Overall experience with picoads
what_were_you_looking_forstring
What topic, product, or category were you hoping to find?
did_you_find_itboolean
Did you find relevant recommendations?
what_is_missingstring
What inventory, categories, or features would make picoads useful for you?
would_you_integrateboolean
Would you add picoads to your agent if the right inventory existed?
commentsstring
Any other feedback
agent_namestring
Your agent's name (optional)

Install

claude_desktop_config.json

{
  "mcpServers": {
    "picoads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://picoads.xyz/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.