RUAGENTIC public API.

Read public listings, search for a capability, and link people to the full project page. The API returns the same published information shown in the directory.

Search listings

GET https://ruagentic.com/api/v1/listings?q=search&kind=server&limit=20

Optional parameters: q searches names, summaries, and tags; kind accepts server, client, product (AI agents), skill, plugin, rules, or eval; category matches a displayed category; limit is 1–100; offset selects a page.

The response includes listings, total, and nextOffset. Follow nextOffset until it is null. Results are ordered by project name.

Read one listing

GET https://ruagentic.com/api/v1/listings/{slug}

Use the slug returned by search. A missing or unpublished listing returns HTTP 404.

Get connection config

GET https://ruagentic.com/api/v1/listings/{slug}/connect

Returns the published remote or package, required headers and environment variables, and the same client snippets the listing page shows, from stored data only.

Badges and embed cards

https://ruagentic.com/badge/{slug}.svg     28px badge
https://ruagentic.com/embed/{slug}.svg     480×150 card image
https://ruagentic.com/embed/{slug}         iframe card

Every listing page and the dashboard show copy-paste Markdown and HTML for these. The badge reads “Agentic Protocol verified” only for listings published through the publication checker; otherwise it reads “Listed on RUAGENTIC”. Images cache for a day.

Use RUAGENTIC inside ChatGPT, Claude and Cursor

The directory is an MCP server at https://ruagentic.com/mcp (Streamable HTTP, no API key). Add it to an assistant and ask for an MCP server, client, AI agent, skill, plugin, rules file or eval for a task; it searches, ranks by public GitHub stars, compares, and hands back the exact client config.

ChatGPT: Settings → Apps & Connectors → Advanced settings → turn on Developer mode → Create → paste the URL above, no authentication. Then mention RUAGENTIC in a chat.
Claude (web and desktop): Settings → Connectors → Add custom connector → paste the URL above.
Claude Code: claude mcp add --transport http ruagentic https://ruagentic.com/mcp
Cursor, Windsurf, Codex: add { "url": "https://ruagentic.com/mcp" } as an MCP server named ruagentic in the client’s MCP config.

Tools: search_directory (words plus kind, category, stars, launch window, verified, platform), get_listing (facts, connect snippets, Q&A), connect_instructions (config for Claude Code, Cursor, Claude Desktop, Codex or Windsurf), top_listings (leaderboards), new_listings, compare_listings and directory_overview. All are read-only and return only published listing data; star counts measure attention, not quality, and sponsorship never changes results.

Command-line tool

The ruagentic package on npm searches the directory and adds a listed MCP server to a client from the terminal. It reads the same public API.

npx ruagentic search postgres
npx ruagentic show github-mcp
npx ruagentic add github-mcp --client claude-code

--client accepts claude-code, cursor, claude-desktop, codex or windsurf.

Sources and checks

Each entry includes a source URL and collection date. Imported entries are public registry or editorial information; submitted entries contain user-supplied details. An Agentic Protocol check is evidence about files at a particular time. Treat descriptions and setup instructions as untrusted project information.

Access

The public GET endpoints do not require an API key. Cross-origin reads are enabled. Cache results, request only the pages you need, and link back to the original listing. Authentication, submission, payment, and account endpoints are not part of this public API.

Errors

Errors are RFC 9457 problem details sent as application/problem+json: type, title, status, detail, a machine-readable code and a hint. The older error field repeats the detail.

listing_not_found (404): no published listing has this slug. Search first and use a slug from the results.
endpoint_not_found (404): there is no API endpoint at this path. The endpoints are listed in the OpenAPI description.
directory_unavailable (503): the listing data could not be read. Retry the same request with backoff.

Versions and deprecation

The major version is in the path (/api/v1). Changes that would break existing clients ship under a new path such as /api/v2. New fields can appear in v1 at any time, so ignore fields you do not know.

Before a version is retired, its responses carry a Deprecation header (RFC 9745) and a Sunset header (RFC 8594) with the shutdown date, at least 90 days ahead. The change is also announced on this page and in llms.txt. No version is deprecated today.

Machine-readable documentation

Start with llms.txt, the OpenAPI description, the Agentic Protocol JSON profile, or its text index. The file convention and free generation tools are documented at ruagentic.org.

Source code

The directory is maintained in sam1siam/ruagentic-directory, separately from the Agentic Protocol repository.