---
title: "agentpluginsdirectory developer resources"
description: "Machine-readable surfaces for Agent Plugins Directory (agentpluginsdirectory.com). Public, read-only except for the allowlisted GitHub-manifest fetch used by the in-browser validator. No API key. No OAuth. No webhooks."
canonical: https://agentpluginsdirectory.com/for-agents
last-updated: 2026-08-22
---

# agentpluginsdirectory developer resources

Machine-readable surfaces for Agent Plugins Directory (agentpluginsdirectory.com). Public, read-only except for the allowlisted GitHub-manifest fetch used by the in-browser validator. No API key. No OAuth. No webhooks.

## When to use these resources

Use them when an agent needs a verified Agent Plugin listing, a census count, a schema check of `plugin.json` / `mcp.json`, or the reproduced 1.0.0 specification. Do not use them as an official registry, a plugin host, or an installer.

## HTTP surfaces

- [https://agentpluginsdirectory.com/llms.txt](https://agentpluginsdirectory.com/llms.txt) — briefing, including when-to-use.
- [https://agentpluginsdirectory.com/llms-full.txt](https://agentpluginsdirectory.com/llms-full.txt) — complete categorized listing.
- [https://agentpluginsdirectory.com/census.json](https://agentpluginsdirectory.com/census.json) — verified index JSON (CC BY 4.0).
- [https://agentpluginsdirectory.com/api/v1/registry-manifest.json](https://agentpluginsdirectory.com/api/v1/registry-manifest.json) — same payload as the census.
- [https://agentpluginsdirectory.com/openapi.json](https://agentpluginsdirectory.com/openapi.json) — OpenAPI 3.1.
- [https://agentpluginsdirectory.com/.well-known/api-catalog](https://agentpluginsdirectory.com/.well-known/api-catalog) — RFC 9727 linkset.
- [https://agentpluginsdirectory.com/mcp](https://agentpluginsdirectory.com/mcp) — read-only Streamable HTTP MCP (search, get plugin, census summary).
- [https://agentpluginsdirectory.com/server.json](https://agentpluginsdirectory.com/server.json) — MCP registry metadata.
- [https://agentpluginsdirectory.com/.well-known/ai-catalog.json](https://agentpluginsdirectory.com/.well-known/ai-catalog.json) — domain MCP discovery.
- [https://agentpluginsdirectory.com/.well-known/mcp/server-card.json](https://agentpluginsdirectory.com/.well-known/mcp/server-card.json) — server card.
- [https://agentpluginsdirectory.com/.well-known/agent-skills/index.json](https://agentpluginsdirectory.com/.well-known/agent-skills/index.json) — skill index.
- [https://agentpluginsdirectory.com/auth.md](https://agentpluginsdirectory.com/auth.md) — how authentication works (none).
- [https://agentpluginsdirectory.com/.well-known/oauth-protected-resource](https://agentpluginsdirectory.com/.well-known/oauth-protected-resource) — RFC 9728 (empty authorization_servers).
- [https://agentpluginsdirectory.com/pricing.md](https://agentpluginsdirectory.com/pricing.md) — machine-readable pricing (free).
- [https://agentpluginsdirectory.com/changelog.md](https://agentpluginsdirectory.com/changelog.md) — on-site surface changelog.
- [https://agentpluginsdirectory.com/sitemap.xml](https://agentpluginsdirectory.com/sitemap.xml) and [https://agentpluginsdirectory.com/sitemap.md](https://agentpluginsdirectory.com/sitemap.md).
- [https://agentpluginsdirectory.com/feed.xml](https://agentpluginsdirectory.com/feed.xml) — blog Atom feed.
- HTML pages also serve `text/markdown` when `Accept` prefers it (`Vary: Accept`).

## Validator helper

`POST /api/fetch-manifest` with `{"url":"https://raw.githubusercontent.com/..."}` returns the file text. Errors use RFC 9457 `application/problem+json`. Rate-limited. Hosts other than GitHub raw and gist are rejected.

## MCP tools

`directory_get_census_summary`, `directory_search_plugins`, `directory_get_plugin`. No authentication.