Skip to content
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. 19 skills free + rate-limited, 12 paid (per-call, or from a plan's monthly credit).

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 slim federation feed work with no key. Rate-limited per IP (30/min on standard discovery, 6/hour on the bulk feed). Hit a 402? Sign in for a Free account key and prepaid balance.

Free account API key

Mint af_… at /account. Pass it as Authorization: Bearer af_… for 60 req/min and prepaid calls. Pro raises it to 600/min, includes $10/month credit and adds webhook alerts.

Enterprise seat · €99/mo

Authorization: Bearer ekey_… spends your $100/month included credit from a data pipeline + 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 prepaid balance.
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