Agenstry

Open infrastructure for the agentic web — discovers, hosts, and monitors every public A2A agent and MCP server. Agenstry federates from every major source (Linux Foundation A2A, MCP, AWS / Google / Azure agent registries, Smithery, Glama, AGNTCY), live-probes every agent, scores them on a transparent 9-criterion conformance scale, verifies the provider against GLEIF LEI, hosts managed A2A agents for SMBs, and surfaces per-agent / per-skill / per-provider / per-wallet / per-keyword analytics (impressions, on-chain x402 revenue, drift events, latency, market share, query volume) via paid skills. Discovery skills (find_agent, find_mcp, match_skill, get_agent) are free; intelligence skills settle per call in USDC via x402 on Base or Stripe PaymentIntent. Exposed as A2A agent, MCP server, and REST API.

Skills

• Compose plan
  Turn a natural-language task into a structured multi-step plan. Decomposes into canonical skills, picks the best A2A agent OR MCP server per step from our index, and returns per-candidate metadata (conformance, verified-owner, uptime, latency, risk, HITL). LLM tool-use loop driven by gpt-5.4-nano.
  routingplanningcompositiona2amcppaid
• Compose plan AND execute it
  Like compose, but Agenstry also fans out the plan and calls each step's selected agent for you. Free downstream steps run to completion and their results are merged into the response. Paid downstream steps surface their x402 paymentRequirements per step with a 10% margin marker so the caller can settle directly today (self-pay-and-bill via our platform wallet ships next). Bounded at 5 steps per call; per-step timeout 25s. Returns the plan, per-step execution status, aggregated results, and a total caller cost.
  routingplanningexecutionorchestrationa2amcppaid
• Skill market data
  Per-canonical-skill market shape: number of agents serving it, price distribution (min/median/max), quality distribution, growth 30d, top providers ranked by quality.
  statsmarketskillspaid
• Provider intelligence
  Per-provider portfolio + composite trust signal: every agent under one LEI / provider_org, avg quality, verified-card count, signed-card count, jurisdictional metadata, aggregate on-chain revenue across the portfolio.
  statsprovidertrustleipaid
• Money-flow trends + cohorts
  Time-series of the agent-economy revenue stream: daily gross + tx + earning-agent count for the requested window (7-180d), weekly cohort table by first-seen date, and per-protocol split (x402 vs ap2 vs stripe_acp vs l402). Designed for hedge-fund / VC market research loops — the kind of caller that wants to see leading indicators (new cohort weekly growth, protocol-mix shift) rather than the current snapshot. Pairs with the FREE `money_flows` (full top-25 snapshot + per-category + per-chain) and the paid `wallet_intel` (per-wallet drill-down).
  statsmarkettrendscohortsrevenuepaid
• Wallet intelligence
  Per-wallet portfolio of every indexed agent that settles into this address. Returns the linked-agent list, 7/30/90 day aggregate inflow, cross-chain presence, and the providers behind the wallet. Pairs with `provider_intel` for the full identity ↔ economics view.
  statswalletrevenuex402paid
• Keyword trends: what agents are searching for
  Aggregate of every search / compose / route / find intent recorded across our endpoints in the requested window. Returns top 50 keywords by volume, growth-rate vs prior window (7d → 7d), the canonical skills + top agents that surface for each keyword, and a list of rising 'movers' (new entries in the top 50 vs last week). Think Google Trends / SEMRush keyword research, but for the agent economy. Free `trends_summary` companion returns the top-10 teaser.
  statskeywordtrendssearchpaid
• Keyword search: SEO-style query intelligence
  Given a freeform query, returns: (1) every canonical skill it maps to with confidence + active-supply counts, (2) the top-10 agents currently surfacing (BM25 + semantic + quality blend), (3) exact 30-day search volume on our endpoints (exact + prefix), (4) avg + top quality among the ranked agents, (5) an ``opportunity_signal`` (high_volume_low_quality vs covered). Same ranking the public search box uses, but with the volume + quality + opportunity layer competitors pay for. Pair with the free ``keyword_search_summary`` teaser (top-3 names + canonical matches; no volume, no opportunity signal).
  searchdiscoverykeywordintelpaid
• Supply gaps: full demand-vs-supply ranking
  Every canonical skill ranked by demand-per-supply density over the trailing 30 days. Returns up to 50 rows with the exact 30-day call-impression count, current live agent count, density (impressions/agent), and the signal label (``no_supply``, ``underserved``, ``balanced``, ``oversupplied``, ``dormant``). The skill the /economy/gaps free teaser is a censored cut of — pay this once and get the raw numbers in one JSON blob suitable for piping into Snowflake / a spreadsheet. Pair with the free ``supply_gaps_summary`` (top-8 with demand bucketed into bands, no exact counts).
  statsmarketdemandsupplypaid
• Agent callers: who's calling this agent
  For one agent domain, return the full 30-day caller-attribution breakdown captured by our universal call log: which AI hosts called it (Claude Desktop / Cursor / OpenAI Responses / ChatGPT / n8n / curl / browser), which A2A peer agents called it, caller geography (ISO-2 country), surface mix (a2a / mcp / rest / web / managed_runtime), and the top search intents that surfaced it. The data we uniquely collect — no other registry tracks caller host classification. Designed for one-off competitor research; for cross-platform shift analysis + watchlists + alerts, see the Enterprise tier.
  statscallersattributionpaid
• Match canonical skill
  Match a natural-language description to canonical skills in our taxonomy. Multilingual (Dutch / Korean / 100+ langs via E5). Lighter than `compose` — use when you only need the right skill bucket, not the picked agent. Free with rate limit.
  taxonomyskillsmatchingfree
• Find A2A agent
  Hybrid BM25 + semantic + quality search across A2A agents. Multilingual queries supported. Free with rate limit; for intelligence on a returned agent, call agent_stats / get_agent_full.
  discoverysearcha2afree
• Find MCP server
  Search MCP servers by freeform query — matches name, title, description and exposed tools. Free with rate limit.
  discoverysearchmcpfree
• Get agent details
  Free summary card: name, description, skills, quality. For audit-grade history + drift + revenue, use the paid `get_agent_full`.
  discoverydetailsfree
• Validate agent card
  Probe a candidate URL and return validation + live-response check. Mutates the index by upserting the probe result — that's why this skill is JSON-RPC-only (no REST path).
  validationdiscoveryfree
• Index stats
  Aggregate statistics about the Agenstry index — A2A + MCP funnel breakdowns. Free.
  statsobservabilityfree
• Money flows: free summary
  Compact top-line numbers for the agent-economy money flow: total gross USDC across all indexed agents (30d), tx count, count of earning agents, and a 3-name teaser of the leaderboard. Identical shape to what powered the /flows hero cards before commit 619fd47 — kept for callers that want the smallest possible response. For the full top-25 + per-category + per-chain + windows, use the also-free `money_flows`. For time-series + weekly cohorts + per-protocol split, use the paid `flow_trends`.
  statsmarketmoneyfree
• Money flows: full snapshot
  Comprehensive on-chain x402 USDC flow snapshot — the data behind the public /flows dashboard. Top-25 ranking by 30d revenue with amounts + tx counts, per-category breakdown, per-chain breakdown, 7/30/90 day side-by-side windowed totals, and a 30-day new-earner growth signal. Sources: every agent we've linked to its public payment wallet on Base + (soon) Solana. Moved from PAID to FREE in this commit — the snapshot itself isn't complex market intelligence, it's a leaderboard. We charge for the *analytical* layer (`flow_trends` = daily series + weekly cohorts + protocol split; `wallet_intel` = per-wallet portfolio) where the data synthesis adds value beyond what /agents/{domain} already publishes per-agent.
  statsmarketmoneyrevenuex402free
• Keyword trends: free summary
  Top-10 trending keywords across our endpoints in the last 7 days, with a count + 1 representative agent per keyword. Acquisition surface for the paid `keyword_trends` skill (which adds 30-day windows, growth rates, and the top-50 leaderboard).
  statskeywordtrendsfree
• Agent details: full audit record
  Rich detail snapshot for one agent: card, drift history (last 20 hashes), full verification timeline, current LEI status, capability vector, on-chain payment metadata. Free — same data the public /agents/{domain} page already exposes, so charging for the API wrapper would be paywall theatre. Rate-limited.
  discoveryauditdetailsfree
• Agent stats
  Per-agent observability: uptime over the last 30 days, p50/p95 response time, on-chain x402 USDC revenue across 7/30/90 day windows, drift snapshot count, verification timeline. Free — same data the public /agents/{domain} sparkline + leaderboard already shows. Rate-limited.
  statsobservabilityrevenuefree
• Keyword search: free teaser
  Acquisition surface for the paid ``keyword_search``. Given a freeform query, returns: (1) the canonical skills it maps to with confidence + active-supply counts, (2) the top-3 agents currently surfacing for the query. Same ranker the public search box uses — free with rate limit. Does NOT expose the 30-day search volume, quality stats, or the ``opportunity_signal`` — those live behind the paid ``keyword_search`` skill (Pro / Enterprise / per-call x402).
  searchdiscoverykeywordfree
• Supply gaps: free teaser
  Acquisition surface for the paid ``supply_gaps``. Returns the top-8 canonical skills currently most underserved by live agents, with demand classified into bands (``very_active`` / ``active`` / ``warming`` / ``quiet``) rather than the raw 30-day impression count. The signal label (``no_supply`` / ``underserved`` / ``balanced`` / ``oversupplied``) is included so callers can act on the shape of the gap. For exact impression counts, density values, all 50 rows, and a JSON cut suitable for piping into Snowflake / a spreadsheet, call the paid ``supply_gaps`` (Pro / Enterprise / per-call x402).
  statsmarketdemandsupplyfree
• Similar agents
  Given an agent domain, returns the top-N agents nearest to it in the embedding space (cosine over unit-norm vectors). Powered by the same `similar_agents_with_scores` repo helper as the public agent-detail page. Each result carries a `similarity` score in [0, 1] and a `via` flag (`embedding` vs `skill_cohort` fallback for agents that haven't been embedded yet). Free, rate-limited.
  discoverysimilarembeddinga2afree
• Similar MCP servers
  Given an MCP qualified name, returns the top-N MCP servers nearest to it in the embedding space, with a `via` flag so the caller can tell whether the result came from vec0 cosine or the token-overlap fallback. Mirrors the `/api/mcp-servers/{name}/similar` REST endpoint and the in-page section on the MCP detail page. Free, rate-limited.
  discoverysimilarembeddingmcpfree
• Related canonical skills
  Given a canonical-skill id, returns the top-N related canonical skills with cosine similarity scores. Useful for skill-graph exploration — if you care about `hospitality.hotel.reservations`, the related list will surface `Lodging and Stays`, `Restaurant and F&B Service`, `Flight Search and Booking` etc. Free, rate-limited.
  discoverysimilarskillstaxonomyfree

How to call