Agenstry

{
  "name": "Agenstry",
  "description": "Open infrastructure for the agentic web \u2014 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.",
  "provider": {
    "organization": "Agenstry",
    "url": "https://agenstry.com"
  },
  "version": "0.3.0",
  "documentationUrl": "https://agenstry.com/mcp-setup",
  "supportedInterfaces": [
    {
      "url": "https://agenstry.com/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "extendedAgentCard": true,
    "extensions": [
      {
        "uri": "https://modelcontextprotocol.io/extensions/discovery/v1",
        "required": false,
        "description": "Model Context Protocol (MCP) endpoint \u2014 same agent exposed as an MCP server for IDE / app callers.",
        "params": {
          "url": "https://agenstry.com/mcp",
          "protocolVersion": "2025-06-18",
          "discoveryUrl": "https://agenstry.com/.well-known/mcp.json"
        }
      },
      {
        "uri": "https://github.com/coinbase/x402/v2",
        "required": false,
        "description": "x402 v2 micropayments (USDC on Base)",
        "params": {
          "discoveryUrl": "https://agenstry.com/.well-known/x402"
        }
      },
      {
        "uri": "https://github.com/google-agentic-commerce/ap2/v1",
        "required": false,
        "description": "AP2 v1 agent-to-agent payment mandates \u2014 discovery only; mandate ingest returns 501 until the merchant-role flow ships. See /.well-known/ap2 for current status.",
        "params": {
          "roles": [
            "merchant"
          ],
          "mandate_types": [
            "cart",
            "payment"
          ],
          "status": "advertised",
          "discoveryUrl": "https://agenstry.com/.well-known/ap2",
          "implemented_at": null
        }
      }
    ]
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "compose",
      "name": "Compose plan",
      "description": "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.",
      "tags": [
        "routing",
        "planning",
        "composition",
        "a2a",
        "mcp",
        "paid"
      ],
      "examples": [
        "compose: schedule an onboarding call with Acme BV and send a prep email",
        "compose: estimate bitcoin fee and accept a USDC micropayment",
        "plan: quote a hotel room for two in Amsterdam next weekend"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "compose_and_execute",
      "name": "Compose plan AND execute it",
      "description": "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.",
      "tags": [
        "routing",
        "planning",
        "execution",
        "orchestration",
        "a2a",
        "mcp",
        "paid"
      ],
      "examples": [
        "execute: find an A2A agent for invoice extraction and pull its agent card",
        "compose_and_execute: search blockchain analytics agents and rank them",
        "run: list MCP servers that expose hotel search tools"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "skill_market",
      "name": "Skill market data",
      "description": "Per-canonical-skill market shape: number of agents serving it, price distribution (min/median/max), quality distribution, growth 30d, top providers ranked by quality.",
      "tags": [
        "stats",
        "market",
        "skills",
        "paid"
      ],
      "examples": [
        "skill_market: pdf_extract",
        "market: blockchain_analytics"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "provider_intel",
      "name": "Provider intelligence",
      "description": "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.",
      "tags": [
        "stats",
        "provider",
        "trust",
        "lei",
        "paid"
      ],
      "examples": [
        "provider_intel: 549300U4SK7P5XWFXX08",
        "provider: tavily"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "flow_trends",
      "name": "Money-flow trends + cohorts",
      "description": "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 \u2014 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).",
      "tags": [
        "stats",
        "market",
        "trends",
        "cohorts",
        "revenue",
        "paid"
      ],
      "examples": [
        "flow_trends",
        "trends: 90",
        "flow_trends: 14"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "wallet_intel",
      "name": "Wallet intelligence",
      "description": "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 \u2194 economics view.",
      "tags": [
        "stats",
        "wallet",
        "revenue",
        "x402",
        "paid"
      ],
      "examples": [
        "wallet_intel: 0x0FF5A6ecef783BBA35463ec2F8403B9B5e9e7C86",
        "wallet: 0x47ffc880cfF2e8F18fD9567faB5a1fBD217B5552"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "keyword_trends",
      "name": "Keyword trends \u2014 what agents are searching for",
      "description": "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 \u2192 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.",
      "tags": [
        "stats",
        "keyword",
        "trends",
        "search",
        "paid"
      ],
      "examples": [
        "keyword_trends",
        "keyword_trends: 90",
        "trends_kw"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "agent_callers",
      "name": "Agent callers \u2014 who's calling this agent",
      "description": "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 \u2014 no other registry tracks caller host classification. Designed for one-off competitor research; for cross-platform shift analysis + watchlists + alerts, see the Enterprise tier.",
      "tags": [
        "stats",
        "callers",
        "attribution",
        "paid"
      ],
      "examples": [
        "agent_callers: silas.sylex.ai",
        "agent_callers: api.deepbluebase.xyz"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "match_skill",
      "name": "Match canonical skill",
      "description": "Match a natural-language description to canonical skills in our taxonomy. Multilingual (Dutch / Korean / 100+ langs via E5). Lighter than `compose` \u2014 use when you only need the right skill bucket, not the picked agent. Free with rate limit.",
      "tags": [
        "taxonomy",
        "skills",
        "matching",
        "free"
      ],
      "examples": [
        "skill: convert PDF invoices to structured JSON",
        "match: een agent vinden die facturen leest"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "find_agent",
      "name": "Find A2A agent",
      "description": "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.",
      "tags": [
        "discovery",
        "search",
        "a2a",
        "free"
      ],
      "examples": [
        "find: hotel reservation agent",
        "search: blockchain analytics"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "find_mcp",
      "name": "Find MCP server",
      "description": "Search MCP servers by freeform query \u2014 matches name, title, description and exposed tools. Free with rate limit.",
      "tags": [
        "discovery",
        "search",
        "mcp",
        "free"
      ],
      "examples": [
        "mcp: github code search",
        "find mcp: postgres database"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_agent",
      "name": "Get agent details",
      "description": "Free summary card: name, description, skills, quality. For audit-grade history + drift + revenue, use the paid `get_agent_full`.",
      "tags": [
        "discovery",
        "details",
        "free"
      ],
      "examples": [
        "get: silas.sylex.ai"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "validate_agent",
      "name": "Validate agent card",
      "description": "Probe a candidate URL and return validation + live-response check. Mutates the index by upserting the probe result \u2014 that's why this skill is JSON-RPC-only (no REST path).",
      "tags": [
        "validation",
        "discovery",
        "free"
      ],
      "examples": [
        "validate: https://example.com"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "index_stats",
      "name": "Index stats",
      "description": "Aggregate statistics about the Agenstry index \u2014 A2A + MCP funnel breakdowns. Free.",
      "tags": [
        "stats",
        "observability",
        "free"
      ],
      "examples": [
        "stats",
        "status"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "flows_summary",
      "name": "Money flows \u2014 free summary",
      "description": "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 \u2014 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`.",
      "tags": [
        "stats",
        "market",
        "money",
        "free"
      ],
      "examples": [
        "flows_summary",
        "flows_basic"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "money_flows",
      "name": "Money flows \u2014 full snapshot",
      "description": "Comprehensive on-chain x402 USDC flow snapshot \u2014 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.\n\nMoved from PAID to FREE in this commit \u2014 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.",
      "tags": [
        "stats",
        "market",
        "money",
        "revenue",
        "x402",
        "free"
      ],
      "examples": [
        "money_flows",
        "flows"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "trends_summary",
      "name": "Keyword trends \u2014 free summary",
      "description": "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).",
      "tags": [
        "stats",
        "keyword",
        "trends",
        "free"
      ],
      "examples": [
        "trends_summary",
        "trending"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_agent_full",
      "name": "Agent details \u2014 full audit record",
      "description": "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 \u2014 same data the public /agents/{domain} page already exposes, so charging for the API wrapper would be paywall theatre. Rate-limited.",
      "tags": [
        "discovery",
        "audit",
        "details",
        "free"
      ],
      "examples": [
        "agent_full: silas.sylex.ai",
        "get_agent_full: tavily.com"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "agent_stats",
      "name": "Agent stats",
      "description": "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 \u2014 same data the public /agents/{domain} sparkline + leaderboard already shows. Rate-limited.",
      "tags": [
        "stats",
        "observability",
        "revenue",
        "free"
      ],
      "examples": [
        "agent_stats: tavily.com",
        "stats_for: api.deepbluebase.xyz"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "keyword_search",
      "name": "Keyword search",
      "description": "Given a freeform query, returns: (1) the canonical skills it maps to, (2) the top agents currently surfacing for that query (BM25 + semantic), (3) the average quality of the matched agents. Same ranking the public search box uses \u2014 free. For the paid analytics layer (volume + growth + supply-gap signals) call `keyword_trends`.",
      "tags": [
        "search",
        "discovery",
        "keyword",
        "free"
      ],
      "examples": [
        "keyword_search: pdf extraction",
        "keyword_search: hotel reservation in Amsterdam"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "similar_agents",
      "name": "Similar agents",
      "description": "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.",
      "tags": [
        "discovery",
        "similar",
        "embedding",
        "a2a",
        "free"
      ],
      "examples": [
        "similar_agents: bitcoinsapi.com",
        "similar: api.deepbluebase.xyz"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "similar_mcps",
      "name": "Similar MCP servers",
      "description": "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.",
      "tags": [
        "discovery",
        "similar",
        "embedding",
        "mcp",
        "free"
      ],
      "examples": [
        "similar_mcps: com.stayker/1stay",
        "similar_mcp: ai.smithery/flight-search-mcp"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "similar_skills",
      "name": "Related canonical skills",
      "description": "Given a canonical-skill id, returns the top-N related canonical skills with cosine similarity scores. Useful for skill-graph exploration \u2014 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.",
      "tags": [
        "discovery",
        "similar",
        "skills",
        "taxonomy",
        "free"
      ],
      "examples": [
        "similar_skills: hospitality.hotel.reservations",
        "related_skills: payments.bitcoin.fee_estimation"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "securitySchemes": {},
  "securityRequirements": [],
  "signatures": [
    {
      "protected": "eyJhbGciOiJFUzI1NiIsImprdSI6Imh0dHBzOi8vYWdlbnN0cnkuY29tLy53ZWxsLWtub3duL2p3a3MuanNvbiIsImtpZCI6ImFnZW50ZmluZGVyLWVzMjU2LTEiLCJ0eXAiOiJKT1NFIn0",
      "signature": "BzR8jtfoeh7-1DqdJVNHyiJTMOC_V4FhiyFZ1AnHVwxnayU6tbBKYUFjt_Dav9xqLG7iq3DmcwH211Xp9mvUDA"
    }
  ]
}