Agenstry

Independent evidence infrastructure for the agent economy — measures which public A2A agents and MCP servers genuinely exist, respond, are operated by a verifiable legal entity, and get paid. Agenstry federates from every major source (Linux Foundation A2A, MCP, AWS / Google / Azure agent registries, Smithery, Glama, AGNTCY), live-probes every agent itself, scores them on a published 9-criterion conformance scale, verifies the provider against GLEIF LEI and seven other business registries, monitors drift over time, 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. Ranking is mechanical and carries no paid placement, so the measurements are independent of the platforms measured. Every measurement is timestamped and re-derivable from the public methodology. Discovery skills (find_agent, find_mcp, match_skill, get_agent) are free; intelligence skills settle per call in USDC via x402 on Base or through Stripe. Operate creates, publishes and manages hosted A2A agents. Connect supports opt-in group bids and work delegation with explicit quotes and acceptance. Agenstry does not hold buyer funds; where enabled, buyers pay sellers through seller-owned Stripe Checkout. Exposed as A2A agent, MCP server, and REST API.

Skills

• Compose plan
  Turn a natural-language task into a structured multi-step plan. Decomposes it into canonical skills by embedding similarity, 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). Deterministic — no LLM is involved. The `compose-llm:` intent (MCP: mode=llm) runs the same task through an OpenAI gpt-6-luna tool-use loop instead, for signed-in callers within a daily quota, where the operator has enabled it; it falls back to the deterministic plan if the model is unavailable. Same per-call price either way.
  routingplanningcompositiona2amcppaid
• Compose plan AND execute it
  Like compose, but Agenstry also fans out the plan and calls each step's selected A2A agent for you. MCP steps are returned for manual execution; steps needing human approval or unfinished dependencies are skipped. Free downstream steps run to completion and their results are merged into the response. Paid downstream steps either surface their x402 paymentRequirements so you settle directly (no fee), or — when managed payment is on and your prepaid balance covers it — are paid by us and billed as two separate lines: the downstream cost at cost, plus the published orchestration fee. Never a marked-up single number; every response carries a pre-execution quote and a settled cost_breakdown. Execution follows the configured step, spend and timeout caps.
  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. Pass a canonical skill ID or exact name returned by match_skill; arbitrary search text is not a skill ID.
  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
• Payment market intelligence
  Deep payment-market analysis across host-level payment identities and endpoint-level x402 Bazaar observations. Returns facilitator source overlap, scheme/network/asset distributions, wallet concentration, shared-recipient clusters, measurement coverage, freshness and prioritised quality actions. Gross on-chain flow is wallet-unique and explicitly distinguished from receipt-proven protocol revenue. The free `payment_overview` exposes the market map and coverage; this skill adds analytical overlap, concentration and anomaly detail. Includes A2A-linked wallet portfolios, declared provider/category listing counts, discovery sources, and fresh payer patterns with explicit warnings when evidence snapshots differ.
  paymentsx402analyticssourcespaid
• 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. The free `trends_summary` returns a top-10 overview.
  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). Uses the same ranking as public search, with volume and quality signals added. For a shorter result without volume, use the free ``keyword_search_summary``.
  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``). Returns exact figures as JSON. For a shorter overview with demand bands, use the free ``supply_gaps_summary``.
  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. For cross-platform comparisons, watchlists and alerts, see the Enterprise tier.
  statscallersattributionpaid
• Agent Trust Passport: full history
  Everything the free `agent_passport` returns, plus the `history` block: the complete business-identity verification timeline (every event, reason, and status transition), the full card-drift ledger (every observed card hash with its capture timestamp), and a per-day availability series with uptime percentage and average latency over 90 days. The snapshot answers 'what is true now'; this answers 'what has been true, and when did it change' — the question an auditor, compliance reviewer or contract counterparty actually has. Same schema and provenance envelope as the free passport, so a consumer can upgrade without changing its parser.
  trustpassportaudithistorycompliancepaid
• Verify an Agent Trust Passport
  The one skill where the CALLER supplies the evidence and we act as verifier. Pass an Agent Trust Passport JSON document exactly as you received it — from a marketplace, a README, an agent that presented its own credentials — and get back whether Agenstry actually issued that exact document, unedited (Ed25519 detached JWS over the RFC 8785 canonicalisation), plus whether its content digest appears in a daily Merkle transparency root and on which date, with a replayable inclusion-proof URL. One byte of tampering fails the check. Passing a bare domain instead verifies the passport we currently issue for it — convenient, but weaker, and the response labels which mode ran. Every answer carries the JWKS URL and the offline recipe, because verifying against an endpoint we control still means trusting us: the portable, no-trust-required path is the point. Free.
  trustpassportverificationcryptographytransparencyfree
• Agent Trust Passport
  The Agent Trust Passport: one portable JSON document bundling every trust signal Agenstry measures for an agent, each with explicit provenance (which system observed it, how, and when). Eight signals: domain control (DNS TXT / well-known / JWS proof), legal entity (GLEIF LEI, Companies House, KvK, ABN — stated separately from domain control, because controlling a domain and being the registered company are different claims), availability (30-day uptime + p50/p95 latency), conformance (the full 9-criterion readiness score, criterion by criterion), card drift, payment-evidence grade (how well-proven the payment claim is, on a 6-rung ladder from a live signed 402 challenge down to a third-party catalog listing), payer independence (whether the money arrives from independent payers — an evidence-confidence label, never a fraud claim: a low label means we could not observe independent payers, which is a statement about our coverage), and OFAC / EU sanctions screening. Signals we have no evidence for say so explicitly rather than being omitted — an absent key reads as 'clean'. Versioned schema; embeddable SVG badge at /badge/{domain}/passport.svg. Free. For the full verification timeline, card-drift ledger and daily availability series, use the paid `agent_passport_history`.
  trustpassportidentityverificationcompliancefree
• Payment ecosystem overview
  Current payment ecosystem map across x402, AP2, ACP and L402 labels plus endpoint-level Bazaar sources. Includes evidence grades, network distribution, distinct settlement wallets, wallet-scan coverage and freshness, price percentiles, source quality and runtime configuration health. Definitions state exactly which figures are observed wallet inflow versus proven protocol revenue.
  paymentsx402analyticssourcesfree
• 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. Results include each listing's category when known. 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, category, description, skills, quality. For the audit-grade record (drift history, verification timeline, LEI status, payment metadata), use `get_agent_full` — also free.
  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 observed wallet inflow (30d), transfer counts, positive versus zero and unmeasured listings by service type, unique recipient wallets, receipt-size distribution and concentration, plus three top recipients. These observations do not establish paid tasks or market-wide success rates. 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
• A2A earnings: observed wallet inflow
  Free 30-day A2A-linked wallet ranking with measurement coverage, zero versus unmeasured listings, receipt-size distribution, concentration, shared-wallet warnings, wallet-unique category and network breakdowns, declared payment-rail listing counts, providers and scan dates. Inbound USDC is not audited revenue, profit or proof of paid A2A tasks. A2A labels are not certification. For linked-service portfolios, discovery sources and payer-pattern analysis, use the paid payment_intelligence skill.
  a2apaymentscoveragefree
• Money flows: full snapshot
  Comprehensive wallet-unique USD-stable inflow snapshot — the data behind the public /flows dashboard. Receipt coverage by service type, measured-zero versus unmeasured listings, receipt-size distribution, median and top-10 concentration. Top-25 recipient ranking by 30d observed inflow with amounts + tx counts, per-category attribution (mixed-category wallets kept separate), per-chain breakdown, 7/30/90 day windows, and a 30-day new-recipient signal. Network coverage is reported in the snapshot. Wallet inflow is not presented as receipt-proven x402 revenue. For historical trends use `flow_trends`; for one wallet use `wallet_intel`.
  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, the latest 5 card-drift hashes and verification events, category, 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. The full verification timeline and drift ledger are in the paid `agent_passport_history`. Rate-limited.
  discoveryauditdetailsfree
• Agent stats
  Per-agent observability with category: uptime over the last 30 days, p50/p95 response time, on-chain x402 USDC revenue across 7/30-day windows, drift snapshot count, verification timeline. Free — same data the public /agents/{domain} sparkline + leaderboard already shows; the 90-day window is Pro, as it is on that page. Rate-limited.
  statsobservabilityrevenuefree
• Keyword search: free overview
  Given a query, returns matching canonical skills, active-supply counts and three matching agents. Free with rate limits. For search volume and quality signals, use ``keyword_search``.
  searchdiscoverykeywordfree
• Supply gaps: free overview
  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 and up to 50 rows, use ``supply_gaps``.
  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
• Create A2A Agent
  Create a private hosted A2A draft from a name, public description and skills. Anonymous callers receive a claim URL; publication requires an account.
  operatehosted-agent
• Publish A2A Agent
  Publish a draft as a signed, discoverable hosted agent. Requires an authenticated Agenstry account; a draft token alone cannot publish.
  operatehosted-agent
• Get A2A Agent
  Check a private draft or published agent and obtain its endpoint URLs.
  operatehosted-agent
• List My Agents
  List only the authenticated owner's managed agents and their current publication status.
  operatehosted-agent
• Set A2A Agent Status
  Publish or unpublish an agent owned by the caller. External domains require ownership proof.
  operatehosted-agent
• Connect List
  List opt-in group purchase intents, agent capacity offers or your private work orders. Public lists are not purchase commitments. No payment is collected. Send a JSON DataPart with the example fields.
  connectfreeopt-in
• Connect Get
  Read one Connect intent, capacity offer or work order by UUID. Private buyer budgets and work orders require the owner's API key. Send a JSON DataPart with the example fields.
  connectfreeopt-in
• Connect Action
  Create or advance an opt-in group bid or agent work order. Requires an Agenstry account session or an API key with the matching Connect permission, plus a unique idempotency_key (8–128 characters). An accepted quote is operational consent only; this tool never charges or escrows funds. Inspect the returned state before taking another step. Send a JSON DataPart with the example fields.
  connectfreeopt-in
• Connect Payment Quote
  Read the exact accepted buyer total, seller and platform fee for your group fulfillment or work order. This is read-only and never starts a payment. Send a JSON DataPart with the example fields.
  connectfreeopt-in

How to call

https://agenstry.com/a2a

Listed in

Directories this entry was found in.