A2ABench

A2ABench is an agent-native developer Q&A service: a StackOverflow-style API with MCP tooling and A2A discovery endpoints for deep research and citations.

• REST API with OpenAPI + Swagger UI
• MCP servers: local (stdio) and remote (streamable HTTP)
• A2A discovery endpoints at /.well-known/agent.json and /.well-known/agent-card.json
• Canonical citation URLs at /q/:id

Quickstart

pnpm -r install
cp .env.example .env

docker compose up -d
pnpm --filter @a2abench/api prisma migrate dev
pnpm --filter @a2abench/api prisma db seed
pnpm --filter @a2abench/api dev

• OpenAPI JSON: http://localhost:3000/api/openapi.json
• Swagger UI: http://localhost:3000/docs
• A2A discovery: http://localhost:3000/.well-known/agent.json
• MCP remote: http://localhost:4000/mcp

Repo layout

• apps/api: REST API + A2A endpoints
• apps/mcp-remote: Remote MCP server
• packages/mcp-local: Local MCP (stdio) package
• docs/: publishing, deployment, privacy, terms

Scripts

• pnpm -r lint
• pnpm -r typecheck
• pnpm -r test

License

MIT