{"name":"harpd-agent-data","version":"1.0.0","description":"Harpd AI product intelligence, purchasable per call by autonomous agents.","protocolVersion":"2026-07-28","protocolVersions":["2026-07-28"],"stateless":true,"transport":{"type":"http","endpoint":"https://api.harpd.com/mcp","method":"POST"},"documentation":"https://harpd.com/developers/agents/","manifest":"https://api.harpd.com/api/agent/v1/manifest","pricing":"https://api.harpd.com/api/agent/v1/pricing","payment":{"protocols":["x402"],"currency":"USDC","network":"base","network_id":"eip155:8453","mode":"mainnet","requires_account":false,"requires_api_key":false,"flow":"call tool → HTTP 402 + PAYMENT-REQUIRED → sign → retry with PAYMENT-SIGNATURE → 200"},"tools":[{"name":"get_historical_data","description":"The rank history of one AI product over 3, 6 or 12 months: position over time, rank movement, best and worst position, and the archived period results. This is the one thing a single page view of the board cannot tell an agent — whether a position is rising or falling. PAID: 0.05 USDC per call, settled over x402 on Base. This tool returns HTTP 402 with x402 payment requirements when no payment is attached; sign the payment and retry. Canonical: https://harpd.com/rank/","pricing_mode":"per_request","price_usd":"0.05","payment_protocols":["x402"],"input_schema":{"type":"object","properties":{"product":{"type":"string","minLength":1,"maxLength":120,"description":"Harpd product slug, e.g. \"claude\"."},"period":{"type":"string","enum":["3m","6m","12m"],"default":"12m"},"scope":{"type":"string","enum":["overall","monthly","weekly"],"default":"overall"},"category":{"type":"string","default":"all"}},"required":["product"],"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"]}},{"name":"get_rank","description":"Free Harpd Rank board for any scope and category, in the unified agent envelope. FREE: no payment, no API key, no account required. Canonical: https://harpd.com/rank/","pricing_mode":"free","price_usd":"0","payment_protocols":[],"input_schema":{"type":"object","properties":{"scope":{"type":"string","enum":["overall","monthly","weekly"],"default":"overall"},"category":{"type":"string","default":"all"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50}},"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"type":"object"}}}},{"name":"harpd_compare","description":"Head-to-head comparison of 2–8 AI products: category, published rank, list pricing where the product is a priced model, and the material differences between them. PAID: 0.01 USDC per call, settled over x402 on Base. This tool returns HTTP 402 with x402 payment requirements when no payment is attached; sign the payment and retry. Canonical: https://harpd.com/compare/","pricing_mode":"per_request","price_usd":"0.01","payment_protocols":["x402"],"input_schema":{"type":"object","properties":{"products":{"type":"array","minItems":2,"maxItems":8,"items":{"type":"string"}}},"required":["products"],"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"]}},{"name":"harpd_optimize","description":"Given a task and the model currently running it, returns cheaper candidate models that still clear the task quality floor, with per-call and projected monthly savings, the performance trade-off, a confidence value and the evidence behind every number. PAID: 0.01 USDC per call, settled over x402 on Base. This tool returns HTTP 402 with x402 payment requirements when no payment is attached; sign the payment and retry. Canonical: https://harpd.com/developers/agents/","pricing_mode":"per_request","price_usd":"0.01","payment_protocols":["x402"],"input_schema":{"type":"object","properties":{"task":{"type":"string","minLength":3,"maxLength":2000},"current_model":{"type":"string"},"max_cost":{"type":"number","exclusiveMinimum":0},"monthly_calls":{"type":"integer","minimum":1,"maximum":100000000},"constraints":{"type":"object","properties":{"min_context_window":{"type":"integer","minimum":1000},"min_tier":{"type":"string","enum":["mini","fast","open","reasoning","flagship"]},"providers":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["task","current_model"],"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"]}},{"name":"harpd_research","description":"A structured research answer over the Harpd catalog: matching products, category distribution, price bands, evidence per claim and the sources behind them. PAID: 0.05 USDC per call, settled over x402 on Base. This tool returns HTTP 402 with x402 payment requirements when no payment is attached; sign the payment and retry. Canonical: https://harpd.com/research/","pricing_mode":"per_request","price_usd":"0.05","payment_protocols":["x402"],"input_schema":{"type":"object","properties":{"query":{"type":"string","minLength":3,"maxLength":500},"limit":{"type":"integer","minimum":1,"maximum":50,"default":15}},"required":["query"],"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"]}},{"name":"search_products","description":"Free keyword search over the published Harpd AI product catalog, with category filters and stable machine-readable results. FREE: no payment, no API key, no account required. Canonical: https://harpd.com/products/","pricing_mode":"free","price_usd":"0","payment_protocols":[],"input_schema":{"type":"object","properties":{"q":{"type":"string","minLength":2,"maxLength":200},"category":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10}},"required":["q"],"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["query","count","results"],"properties":{"query":{"type":"string"},"count":{"type":"integer"},"results":{"type":"array"}}},"meta":{"type":"object"}}}},{"name":"verify_agent_payment","description":"A deliberately trivial paid product that exists so an agent can prove its whole x402 payment path — 402 challenge, signing, settlement, receipt — before it spends anything on data. Costs $0.01 and returns the request it received plus the settlement receipt. PAID: 0.01 USDC per call, settled over x402 on Base. This tool returns HTTP 402 with x402 payment requirements when no payment is attached; sign the payment and retry. Canonical: https://harpd.com/developers/agents/","pricing_mode":"per_request","price_usd":"0.01","payment_protocols":["x402"],"input_schema":{"type":"object","properties":{"echo":{"type":"string","maxLength":200,"description":"Any string; returned unchanged so the caller can correlate the round trip."}},"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"]}}]}