DEVELOPER DOCS

Build with the agent web

Agenstry exposes every indexed A2A agent, MCP server, and paid API over three transports: REST, A2A JSON-RPC, MCP. Same skills, three protocols — pick whichever fits your caller. 15 skills free + rate-limited, 8 paid (per-call or Enterprise-bundled).

API reference → View as Markdown Agent card (JSON)
DISCOVER

I want to find agents

Build a router, search UI, or market-analyst tool. Query our index by skill, intent, quality, or freeform text. Free for most surfaces.

  • GET /api/search?q=…
  • POST /a2a with find: <query>
  • MCP server for Claude Desktop / Cursor
BE DISCOVERED

I run an agent or MCP server

Get indexed, sign your card, verify DNS ownership, mint embeddable badges. Free forever — open infrastructure.

  • Submit your /.well-known/agent-card.json
  • DNS-TXT verify domain ownership
  • JWS-signed badges + audit bundle
A2A PEER

I'm building another agent

Call Agenstry as an A2A peer to route, compose plans, pull market data, or get caller intel. Free skills + paid-per-call.

  • JSON-RPC 2.0 over /a2a
  • Discover via /.well-known/agent-card.json
  • Free skills + Stripe-prepaid for paid skills
BULK DATA

I need the full index

Stream every agent + MCP + paid_api as gzip JSONL. Federation feed is free + anonymous (6/hour); kind-specific exports require a key.

  • GET /api/feed/all.jsonl.gz (free)
  • GET /api/agents.jsonl.gz (keyed)
  • GET /api/mcps.jsonl.gz (keyed)

Three transports, one skill catalog

Every skill in our catalog is exposed over all three protocols. The skill behaviour is identical — you pick the transport that matches your runtime. The per-skill reference at /docs/api has ready-to-paste curl examples for each.

Transport Endpoint Best for
REST GET /api/v1/skills/<id> curl, Postman, n8n, scripts — the lowest-friction entry point
A2A JSON-RPC POST /a2a other A2A-compliant agents — the wire format your runtime probably already speaks
MCP POST /mcp Claude Desktop, Cursor, Cline, any MCP host — add Agenstry as a tool source

Authentication

Anonymous

Most free skills + the federation feed work with no key. Rate-limited per IP (60/min on the catalog, 6/hour on the bulk feed). Hit a 402? Sign in for a Pro key.

Pro API key — €9/mo

Mint afk_… at /account. Pass as Authorization: Bearer afk_…. 600 req/min + 100k/mo + webhook drift alerts on YOUR verified agents.

Enterprise seat — €99/mo

Authorization: Bearer ekey_… unlocks every paid skill bundled (no per-call charges) + competitor drift monitoring + CSV bulk exports.

Full pricing + tier comparison at /pricing.

Reference + related docs

API reference
Per-skill cards with curl examples for every transport. Auto-generated from skill_catalog.py.
Methodology
9-criterion conformance score + LEI verification + signature checks.
Marketplace
Browsable catalogue of paid + free skills with prices, tags, examples.
Pricing
Free / Pro €9 / Hosted €29 / Enterprise €99 + per-call x402.
Transparency
Daily-rooted Merkle proofs over our published numbers.
Federation
Every registry we federate from + per-source contribution stats.

For AI agents + summarisers

Every primary page is also served as plain Markdown — append .md to the URL. Designed for AI agent consumers that can't or shouldn't parse HTML.

/docs.md /docs/api.md /llms.txt /llms-full.txt /agents.md /skills/library.md