# Agenstry developer docs

> Open infrastructure for the agentic web — discover, host, monitor every public A2A agent and MCP server. This page is the entry-point to every developer surface we expose: API reference, A2A JSON-RPC protocol, MCP server, bulk feed, identity verification, paid skills (x402 USDC).

## Quickstart by persona

### I want to discover agents (build a router / search UI / market analyst)

- **REST search** — `GET https://agenstry.com/api/search?q=…` (BM25 + cosine + RRF across A2A + MCP, multilingual)
- **A2A JSON-RPC** — `POST https://agenstry.com/a2a` with `message/send` + intent `find: <query>`
- **MCP** — connect Agenstry's MCP server to Claude Desktop / Cursor / any MCP host
- **Bulk feed** — `GET https://agenstry.com/api/feed/all.jsonl.gz` (gzip JSONL, every agent + MCP + paid_api, free + anonymous, 6/hour)

→ API reference: https://agenstry.com/docs/api  ·  Markdown: https://agenstry.com/docs/api.md

### I want to be discovered (I run an agent or MCP server)

- **Submit** — paste your agent-card.json URL at https://agenstry.com/submit
- **Verify** — DNS TXT verification proves owner of the domain (https://agenstry.com/methodology)
- **Sign your card** — JWS signatures rank higher in our conformance scoring
- **Get an embeddable badge** — https://agenstry.com/badges  (drives organic backlinks)

### I'm building an A2A peer (another agent that calls Agenstry)

- **Agent card discovery** — `GET https://agenstry.com/.well-known/agent-card.json`
- **A2A endpoint** — `POST https://agenstry.com/a2a` (JSON-RPC 2.0, A2A v1 spec)
- **Skills you can invoke** — free: `find_agent`, `find_mcp`, `match_skill`, `get_agent`, `validate_agent`, `index_stats`. Paid (x402 USDC + Stripe prepaid): `compose`, `flow_trends`, `wallet_intel`, `keyword_trends`, `agent_callers`, `provider_intel`, `skill_market`, `compose_and_execute`.
- **Paid skill payments** — Stripe prepaid (top up at https://agenstry.com/account#prepaid-wallet) OR Enterprise seat (https://agenstry.com/pricing#enterprise). x402 USDC settlement coming soon.

### I want bulk data for analytics / training

- **Federation feed** — `GET https://agenstry.com/api/feed/all.jsonl.gz` (free + anonymous, every kind, every signal)
- **Agents-only** — `GET https://agenstry.com/api/agents.jsonl.gz` (auth required, 10/hour)
- **MCPs-only** — `GET https://agenstry.com/api/mcps.jsonl.gz` (auth required, 10/hour)
- **State of the Agent Economy** — weekly LLM-generated briefing at https://agenstry.com/reports/state-of-agent-economy

## Authentication

- **Anonymous** — most free skills + the federation feed work with no key. Rate-limited per IP (60/min).
- **API key** — Pro tier (€9/mo) mint at https://agenstry.com/account#api-keys. Pass as `Authorization: Bearer afk_…`. 600 req/min (10× the anonymous limit). No monthly cap — we throttle, never overage-bill.
- **Enterprise seat** — `Authorization: Bearer ekey_…`. Unlimited rate, all paid skills bundled.

Pricing: https://agenstry.com/pricing

## Transports

- **REST** — `https://agenstry.com/api/v1/skills/<skill_id>?<arg>=<value>` — every skill mirrored at a stable URL.
- **A2A JSON-RPC** — `POST https://agenstry.com/a2a` with `method: "message/send"` and `params.message.parts[0].text: "<intent>: <arg>"`. Returns A2A v1 `result.kind=message` envelope.
- **MCP** — `POST https://agenstry.com/mcp` with `method: "tools/call"` and `params.name: "<skill_id>"`. Initialize first with `method: "initialize"`.

Same skill, three transports. Pick whichever fits your caller.

## AI-friendly surfaces

Append `.md` to any of these for the Markdown mirror:

- https://agenstry.com/docs.md, https://agenstry.com/docs/api.md — these docs as plain markdown
- https://agenstry.com/agents.md — every indexed agent
- https://agenstry.com/skills/library.md — SKILL.md / AGENTS.md / CLAUDE.md procedural-knowledge index
- https://agenstry.com/intel/<domain>.md — competitor intel on any agent
- https://agenstry.com/reports/state-of-agent-economy.md — weekly briefing

And the LLM discovery files: https://agenstry.com/llms.txt + https://agenstry.com/llms-full.txt (Stainless pattern).