# agentkit.md — the agent-ready plugin registry — full guide

agentkit.md is a public, agent-ready registry of plugin cards: structured, AI-generated profiles of agent-harness plugins (what a plugin does, how to install it, which platforms and agents it supports), served over a keyless REST API, an MCP server, and a searchable catalog.

## Scope

Cards cover the Herdr agent harness (https://herdr.dev) today.
Expanding to additional harnesses is the roadmap. Every card is generated by an
AI model from the plugin's public README and manifest data, and every generated
field carries evidence so a human reviewer can verify it.

## Card schema

A card is a JSON object with these fields:

- `key` — unique identifier in `owner/repo` form (GitHub owner + repository).
- `name` — human-readable plugin name.
- `description` — one-line summary of what the plugin does.
- `description_full` — longer prose description.
- `excerpt` — short quoted excerpt from the source README.
- `install` — install command or instructions (null when unknown).
- `surface` — what the plugin extends: one of pane, action, event, startup, external, unclear.
- `platforms` — supported platforms: macos, linux, windows, unknown.
- `agents` — agents known to work: claude, codex, grok, opencode, cursor, devin, any, none.
- `integrations` — external services the plugin connects to.
- `raw_tags` — tags carried over from the source material.
- `purposes_guess` — model-guessed purpose categories (notify, monitor, files, ...).
- `evidence` — quotes from the README supporting the generated fields.
- `quality` — generation confidence: thin, ok, or solid.
- `harness` + `model` — which harness the card targets and which model produced it.

## REST API

All reads are keyless. Base URL: https://agentkit.md

List the catalog:

    curl https://agentkit.md/api/v1/plugins

Fetch one card (key is owner/repo):

    curl https://agentkit.md/api/v1/cards/acme/notify

Natural-language search:

    curl "https://agentkit.md/api/v1/search?q=desktop+notifications"

Registry statistics:

    curl https://agentkit.md/api/v1/stats

Full request/response details: https://agentkit.md/openapi.json and https://agentkit.md/docs

## MCP

An MCP server is available over streamable HTTP at https://agentkit.md/mcp
(server name `agentkit-md`, version 1.0.0). Configure your MCP
client with that URL to search and retrieve cards without raw REST calls.

## Policies

No authentication, no API keys, no tracking cookies. The registry and API are
free and fairly rate-limited. See https://agentkit.md/pricing.md and https://agentkit.md/privacy.