MCP Server

picoads

xyz.picoads/picoads
Marketing & Advertising Public & reachable MCP 2025-11-25

What this MCP does

Provides sponsored recommendations and affiliate link monetization, with registration, publisher analytics, and USDC earnings support.

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.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['agent_id'], 'properties': {'days': {'type': 'number', 'description': 'Lookback window in days (default 30)'}, 'hub_id': {'type': 'string', 'description': 'Filter by hub'}, 'agent_id': {'type': 'string', 'description': 'Your agent ID'}}}
complete_registration
Complete agent registration with your signed wallet message. Call register_agent first to get the message to sign.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['wallet_address', 'name', 'description', 'eip191_signature', 'nonce', 'timestamp'], 'properties': {'name': {'type': 'string', 'description': "Your agent's display name"}, 'nonce': {'type': 'string', 'description': 'The nonce from register_agent response'}, 'timestamp': {'type': 'string', 'description': 'The timestamp from register_agent response'}, 'description': {'type': 'string', 'description': 'What your agent does'}, 'wallet_address': {'type': 'string', 'description': 'Your EIP-55 checksummed Ethereum address'}, 'bootstrap_token': {'type': 'string', 'description': 'Bootstrap token from anonymous get_recommendations responses. Claims prior anonymous serves on registration.'}, 'eip191_signature': {'type': 'string', 'description': 'The EIP-191 signature from signing the auth message returned by register_agent'}, 'payment_signature': {'type': 'string', 'description': 'The base64-encoded x402 payment signature (only required if registration has a fee)'}}}
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.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'topic': {'type': 'string', 'description': "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."}, 'context': {'type': 'string', 'description': "What the user is looking for â\x80\x94 improves relevance. E.g. 'comparing DeFi yield protocols' or 'looking for AI agent frameworks'."}, 'max_results': {'type': 'number', 'default': 3, 'description': 'Maximum number of sponsored recommendations to return (default: 3)'}}}
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.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['rating'], 'properties': {'rating': {'enum': ['great', 'okay', 'poor'], 'type': 'string', 'description': 'Overall experience with picoads'}, 'comments': {'type': 'string', 'description': 'Any other feedback'}, 'agent_name': {'type': 'string', 'description': "Your agent's name (optional)"}, 'did_you_find_it': {'type': 'boolean', 'description': 'Did you find relevant recommendations?'}, 'what_is_missing': {'type': 'string', 'description': 'What inventory, categories, or features would make picoads useful for you?'}, 'would_you_integrate': {'type': 'boolean', 'description': 'Would you add picoads to your agent if the right inventory existed?'}, 'what_were_you_looking_for': {'type': 'string', 'description': 'What topic, product, or category were you hoping to find?'}}}
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.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': '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.
Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['wallet_address', 'name', 'description'], 'properties': {'name': {'type': 'string', 'description': "Your agent's display name"}, 'description': {'type': 'string', 'description': "What your agent does (e.g., 'DeFi newsletter with 12K subscribers')"}, 'wallet_address': {'type': 'string', 'description': 'Your EIP-55 checksummed Ethereum address'}, 'bootstrap_token': {'type': 'string', 'description': 'Bootstrap token from anonymous get_recommendations responses. Pass this to claim prior anonymous serves on registration.'}}}
Added
leave_feedback
Sept. 17, 2026, 12:55 p.m.
Added
check_publisher_stats
Sept. 17, 2026, 12:55 p.m.
Added
complete_registration
Sept. 17, 2026, 12:55 p.m.
Added
register_agent
Sept. 17, 2026, 12:55 p.m.
Added
monetize_link
Sept. 17, 2026, 12:55 p.m.
Added
get_recommendations
Sept. 17, 2026, 12:55 p.m.