Skip to content

bitrouter/agents-database

Repository files navigation

Agents Database

An open-source database of AI agents, using the A2A Agent Card schema for structured registry.

Live at: agents.bitrouter.ai

What is this?

Models have models.dev. Tools have MCP registries. Agents need a database too.

Agents Database is a community-driven registry of AI agents — any agent, any protocol. Each agent is described by a TOML file using the A2A Agent Card schema as a standard format for structured metadata, validated on every PR, and served as a public JSON API.

Quick Start

Browse Agents

Visit agents.bitrouter.ai to search and explore registered agents.

Use the API

curl https://agents.bitrouter.ai/agents.json

Returns all registered agents as a JSON object keyed by slug.

Register Your Agent

  1. Fork this repo
  2. Add agents/your-agent/agent.toml (see CONTRIBUTING.md)
  3. Submit a PR

Or use the Register New Agent issue template.

Repository Structure

agents-database/
├── agents/                   # Community-contributed agent definitions
│   └── {agent-slug}/
│       ├── agent.toml        # A2A Agent Card (TOML)
│       └── logo.svg          # Optional logo
├── packages/
│   ├── core/                 # Schema validation + API generation
│   └── web/                  # Next.js frontend
├── .github/workflows/        # CI validation + deployment
├── CONTRIBUTING.md
└── README.md

Agent Card Schema

Agent TOML files use the A2A Agent Card schema as a standard format for agent metadata:

name = "My Agent"
description = "A production-ready AI agent"
version = "1.0.0"
endpoint = "https://my-agent.example.com/a2a"

[provider]
organization = "My Org"
url = "https://myorg.com"

[capabilities]
streaming = true
pushNotifications = false

[[skills]]
id = "my-skill"
name = "My Skill"
description = "What this skill does"
inputModes = ["text"]
outputModes = ["text"]

[[interfaces]]
protocol = "a2a"
version = "1.0.0"

[securitySchemes.bearer]
type = "http"
scheme = "bearer"

See CONTRIBUTING.md for the full schema reference.

Development

pnpm install          # Install dependencies
pnpm run validate     # Validate all agent.toml files
pnpm run generate     # Generate agents.json from TOML
pnpm run dev          # Start frontend dev server
pnpm run build        # Full build (generate + Next.js)

License

MIT

About

An open-source database of LLM agents

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors