> ## Documentation Index > Fetch the complete guide index at: https://www.synscribe.com/agentic-discovery/llms.txt > Use this file to discover all pages before exploring further. --- title: "AI Agent Registries & Directories: The 4 That Matter" description: "Only 4 AI agent registries show measured impact — ~99% of MCP distribution bypasses the rest. Tier table, submission runbooks, and the junk tier to skip." slug: /agentic-discovery/ai-agent-registries-and-directories series: "The Agentic Discovery Playbook — Play 2 of 11 · GET FOUND" last_verified: 2026-06-11 --- # AI Agent Registries & Directories: the 4 That Matter (and the Junk Tier) > **In short:** Only four agent-registry placements show measured impact as of 2026-06-11: the Official MCP Registry (which feeds GitHub's registry and renders natively in VS Code), skills.sh (~1.38M weekly CLI downloads), Anthropic's Connectors Directory and plugin marketplace, and Context7 (~1.14M weekly npm downloads). Roughly 99% of real distribution bypasses standalone directories. List in those four; skip the rest. ## Do this now - [ ] Publish to the Official MCP Registry via `mcp-publisher` (free, ~1 hour); confirm your entry renders in VS Code's Extensions view under `@mcp`. - [ ] Make your skills repo public with SKILL.md files — skills.sh lists it automatically, no submission — and embed the badge in your README. - [ ] File your Anthropic Connectors Directory submission today (review takes days–weeks) and prepare a `.claude-plugin/marketplace.json` listing. - [ ] Submit your **docs site** (not your repo) to Context7 at context7.com/add-library; claim the entry and configure parsing. - [ ] Rewrite your Context7 description to contain the exact category words developers type — after checking who wins those queries today. - [ ] Spend ≤2 hours on Tier 2: PulseMCP, Smithery, and a Cursor "Add to Cursor" deeplink on your own docs. - [ ] Skip mcp.so, Glama, mcpmarket, awesome-lists, mcp-get, and ClawHub — and write down that you skipped them, so nobody "fixes" it later. - [ ] Stand up the weekly position tracker (below) before calling this play done. > 📥 **Free resource:** [Registry Submission Runbook worksheet](/agentic-discovery/resources/registry-submission-runbook) ## Who needs this play? Anyone who ships an MCP server ([Play 3](/agentic-discovery/mcp-server-distribution)), a skills repo ([Play 4](/agentic-discovery/agent-skills-and-agents-md)), or docs that developers integrate against. Registries are where agents and their host clients resolve "what exists" for a task — but only a handful feed real traffic, so most of this play is about where *not* to spend time. Scope note: this play covers the *structured* indexes agents pull from deliberately (Context7, the MCP registry). For the *open-web* search an agent runs itself — appearing in its results, surviving the fetch, and getting past its verification — see [Play 1](/agentic-discovery/ai-agent-web-search-and-fetch). They're complementary discovery surfaces. Prerequisites: a public GitHub org, a docs site, and DNS control for namespace verification. Budget 1–2 days for Tier 1, then about an hour a week of tracking. ## Why do ~99% of installs bypass standalone directories? One data point clarifies the entire landscape. As of 2026-06-11, Context7's MCP client (`@upstash/context7-mcp`) does **1,136,447 npm downloads per week** — and on Smithery, the best-known standalone MCP directory, the same product shows just **6.8K "uses."** Roughly **99.4% of its real distribution bypasses standalone directories entirely.** Distribution flows through npm, native client surfaces (VS Code's Extensions view, Claude Code's `/plugin`), and vendors' own docs funnels. Standalone directories mostly mirror demand that already exists; they rarely create it. So we tiered every registry strictly by evidence: **native client integration > published measured usage > third-party traffic estimates > GitHub stars > self-reported server counts** (the last is worthless alone). Four placements survive the cut. ## Which AI agent registries actually matter? | Tier | Surface | Why it ranks there | Cost | |---|---|---|---| | **1** | Official MCP Registry → GitHub MCP Registry → VS Code | The only registry rendered natively inside a major client (`@mcp` in the Extensions view) | ~1 hr, free | | **1** | skills.sh (Vercel) | Measured installs, ~55 supported agents, zero gatekeeper | ~1 day (write the skills) | | **1** | Anthropic Connectors + claude-plugins-official | Reviewed; surfaced in-product in Claude and in Claude Code's `/plugin` | days–weeks review | | **1** | Context7 | ~1.14M weekly npm downloads of its client; the only directory with an ownable quality loop | ~1 hr + curation | | 2 | PulseMCP | Hand-reviewed daily; transparent that its numbers are estimates; real MCP-developer audience | minutes | | 2 | Smithery | Legitimate, but measured usage is tiny; hosted runtime/auth has some value | ~1 hr | | 2 | Cursor deeplinks | A native one-click install path you control from your own docs — no listing needed | minutes | | 3 | mcp.so, Glama, mcpmarket, awesome-lists, mcp-get | Server counts only — no client integration, no usage data | skip | | 3 | ClawHub | Documented malware epidemic (see below) | skip | ## How do you get listed in the four Tier-1 surfaces? ### 1. Official MCP Registry — the upstream pipe (~1 hour) Not because users browse registry.modelcontextprotocol.io — they don't. Its documented consumers include Smithery, PulseMCP, Docker Hub, Anthropic, and GitHub; the GitHub MCP Registry sources from it, and **VS Code/Copilot renders the GitHub MCP Registry natively** in the Extensions view. One free listing propagates downstream into the only registry a major client queries by default. 1. Install the `mcp-publisher` CLI (github.com/modelcontextprotocol/registry). 2. Pick a namespace: `io.github./` (verified via GitHub OIDC) or reverse-DNS `com./` (DNS TXT or HTTP challenge). 3. Write `server.json`: name, description, package or remote endpoint, version. 4. Run `mcp-publisher login github`, then `mcp-publisher publish`. 5. Confirm the entry appears in the GitHub MCP Registry, then search `@mcp ` in VS Code's Extensions view. 6. Re-publish on every release so downstream consumers carry current metadata. Enterprise note: organizations can repoint VS Code's gallery via the `McpGalleryServiceUrl` policy — but the default gallery is what most users see. ### 2. skills.sh — there is no submission step Any public GitHub repo containing SKILL.md files becomes installable via `npx skills add owner/repo`, and the leaderboard auto-populates from install telemetry. Your work is repo quality ([Play 4](/agentic-discovery/agent-skills-and-agents-md) covers it), plus embedding the badge (`https://skills.sh/b/owner/repo`) in your README. Set expectations correctly: installs are driven by **your own funnels** — docs, README, launch posts — not by directory browsing. The leaderboard is the scoreboard, not the channel. Counts are telemetry-based and cache-noisy; treat them as order-of-magnitude. ### 3. Anthropic surfaces — reviewed, and not redundant Submit to the Connectors Directory (claude.com/connectors; ~439 reviewed connectors, queried in-product) and prepare a Claude Code plugin marketplace listing — claude-plugins-official ships pre-loaded in Claude Code's `/plugin` Discover view. The trap: **Claude Code's `/mcp` does not browse the Official MCP Registry.** Being in the official registry buys you nothing on the Claude surface; these are separate, parallel placements. Budget days-to-weeks for review and meet the security and annotation requirements before submitting. ### 4. Context7 — the one directory with a quality loop you control Context7's install base is real, measured demand for docs retrieval — and unlike every other directory, you can tune your entry: 1. Submit the **docs site, not the GitHub repo**, at context7.com/add-library. Site entries outscore repo entries — Convex's site entry benches 91.6 vs 79.9 for its repo, an 11.7-point spread from source choice alone. Repos carry README and contributor noise. 2. Claim ownership and set the parse config: branch, include/exclude folders (exclude changelogs, blog, marketing pages). 3. Write **custom benchmark questions** — the questions a developer integrating your product would actually ask. An LLM jury re-scores your entry from your snippets on every parse. 4. Set a re-parse cadence tied to docs releases. Freshness correlates with benchmark score (Spearman −0.54 against log hours-stale; the freshest five entries we audited average 83.6 vs 72.3 for the stalest five). ## How do you write a description that wins category queries? Context7's lexical search matches names and descriptions — which makes the description field a ranking surface, and right now a largely uncontested one. The receipt, verified 2026-06-11: on the query **"payments"**, DodoPayments ranks #1 (11,647 snippets, benchmark 83) while Stripe — 265,284 snippets, benchmark 84.5 — **is absent from that query's top-10**, because its entry is named simply "stripe." Smaller player, better description-to-query fit, category win. Entire shelves sit empty, too. The query **"accept crypto payment"** returns a wasteland: the top snippet source is Crypto++, a C++ cryptography library — no relevant product surfaces at all. Read that as category-vacancy evidence, not a payments story: **task-phrase lexical space is unclaimed across categories**, and the first product to put the phrase in its description owns the shelf. The runbook: 1. Enumerate the 5–10 category nouns and verb phrases for your space ("auth", "send email", "vector database", and the task phrases your users type). 2. Run each query on Context7 today and record who wins. 3. Rewrite your description to contain those exact terms — naturally phrased, not stuffed. 4. Re-check positions weekly (tracker below). ## Which directories should you skip — and why is ClawHub a brand risk? **Tier 3 — skip, or cap at five minutes for the backlink.** mcp.so (~19.7K listed servers), Glama (~21–34K), and mcpmarket publish scrape-driven server counts with no client integration and no published usage. The awesome-mcp lists are star-counting; mcp-get is dormant. Hours in, nothing measurable out. **ClawHub — skip, and document why.** OpenClaw's skill registry (~10.7–13.7K skills) carried **341 confirmed malicious skills** distributing the AMOS stealer (The Hacker News, Feb 2026); Snyk's count ran to 1,467, and third-party estimates put 8–20% of the registry as malicious. Listing there creates brand-risk adjacency. Only consider it if OpenClaw users are specifically your market — and put that decision in writing. Two non-directory notes while you're here. **Codex has no registry at all** — configuration is `config.toml` only, and discovery is an open feature request (openai/codex#25750); your Codex placement is install snippets in your own docs. And Cursor's in-product MCP directory appears curated/BD-gated with no public self-serve process we could verify — don't block on it; publish "Add to Cursor" deeplinks instead (cursor.com/docs/context/mcp/install-links), which work without any listing. ## What's the full submission runbook? | Registry | Mechanism | Verification | Time | Renewal | |---|---|---|---|---| | Official MCP Registry | `mcp-publisher` CLI + server.json | GitHub OIDC or DNS/HTTP challenge | ~1 hr | re-publish on releases | | GitHub MCP Registry / VS Code | automatic downstream of the above | search `@mcp` in VS Code | 0 | automatic | | skills.sh | none — public repo with SKILL.md | telemetry auto-lists | ~1 day (write the skills) | commit to repo | | Anthropic Connectors | claude.com/connectors submission | human review | days–weeks | per policy | | claude-plugins-official | marketplace submission | curated review | days–weeks | versioned | | Context7 | context7.com/add-library + claim | org/domain signals | ~1 hr + curation | re-parse per docs deploy | | PulseMCP | site submission | human review (daily) | minutes | automatic | | Smithery | site/CLI publish | account | ~1 hr | automatic | | Cursor deeplink | button on your own docs | none | minutes | none | ## How do you track registry positions weekly? Automate five checks (cron or CI), append results to a dated CSV, and alert on any FAIL or two consecutive WARNs: 1. **Official registry presence** — `GET registry.modelcontextprotocol.io/v0/servers?search=` returns your entry at the current version. FAIL if absent or stale by more than one release. 2. **VS Code surface** — the GitHub MCP Registry page for your server resolves. FAIL on 404. 3. **skills.sh installability** — `npx skills add /` exits 0 in a clean container; log the install count as a trend line (order-of-magnitude only — counts are cache-inconsistent). 4. **Context7 position** — rank for each of your five target task queries, plus benchmark score and last-parse timestamp. PASS = top-3 on the primary term; WARN on a ≥2-position weekly drop; FAIL if the benchmark falls below 80 or staleness exceeds 14 days. 5. **PulseMCP visitor estimate** — secondary trend line only; npm weekly downloads of your own MCP package remain the honest ledger everything else calibrates against. Quarterly, re-verify the tier table itself. This landscape reshuffled twice in the past year — ClawHub's rise and contamination, and the GitHub registry's VS Code integration — so the tiers have a shelf life. Full measurement design lives in [Part 5](/agentic-discovery/measure-ai-visibility). ## The receipts All figures verified 2026-06-11; methodology and updates in the [Data Room](/agentic-discovery/data). | Channel | Measured evidence | Evidence type | |---|---|---| | skills.sh (Vercel) | `skills` CLI: 1,376,225 npm downloads/week; top skill 1.4M installs; ~55 agent clients written by one command | Measured (CLI telemetry + npm) | | Context7 | `@upstash/context7-mcp`: 1,136,447 npm downloads/week; ~56.5K GitHub stars | Measured (npm) | | GitHub MCP Registry → VS Code | Rendered natively in VS Code's Extensions view (`@mcp`) — the only registry surfaced by default inside a major client | Native integration | | Anthropic Connectors + claude-plugins-official | ~439 reviewed connectors; plugin marketplace pre-loaded in Claude Code | Native integration | | Smithery | Visible "uses": Exa 23.2K, Clay 20.2K, Context7 just 6.8K (vs 1.14M/wk on npm) | Measured (small) | | PulseMCP | ~11.8K servers, hand-reviewed; publishes per-server visitor estimates (Context7 ≈747K/wk) | Estimates | | mcp.so / Glama / mcpmarket | 19.7K–34K listed servers; no usage data, no client integration | Server counts only | | ClawHub | ~10.7–13.7K skills; 341 confirmed malicious | Scale + documented malware | **Selection evidence (pilot-grade).** In our pilot experiment E4 (single model — Haiku 4.5 — n=2 per arm, 2026-06-11), telling an agent that one email provider ships MCP + llms.txt + skills flipped its provider selection 2/2; the control arm chose the other provider 2/2. Discovery surfaces are now a selection criterion, not just a convenience — but treat this as a pilot, not a benchmark. **Vendor-scale numbers on skills.sh** (~95 official vendor orgs, including Stripe, Supabase, Clerk, and Auth0): Microsoft 4.5M installs aggregate, Convex 362.1K, Better Auth 115.5K, Resend 17.6K, DodoPayments 3.9K. Zero-gatekeeper listing, real measured numbers — but cache-inconsistent (shadcn's totals varied 63.9–133.9K between page loads), so order-of-magnitude only. **Counterexamples we audited.** Crossmint ships a docs MCP, llms.txt, and agent-facing APIs, yet has no findable Context7 entry — full build cost, near-zero retrieval presence. Hono's repo-sourced Context7 entry: 48 snippets, benchmark 63.3, absent from the top-50 (a deliberate infrastructure positioning, but the retrieval invisibility is the measurable consequence). **Data-quality labels we use in every report:** measured (npm downloads, skills.sh telemetry) > estimated (PulseMCP visitors) > vanity (Tier-3 server counts). "No usage evidence" for Tier 3 is absence of evidence — but after deliberate search, and the burden of proof is on the directory. ## FAQ **Where should I list my MCP server?** Four placements show measured impact: the Official MCP Registry (which propagates to GitHub's registry and VS Code), skills.sh for your skills repo, Anthropic's Connectors Directory plus plugin marketplace, and Context7 for your docs. PulseMCP, Smithery, and Cursor deeplinks are cheap Tier-2 additions; everything else is skippable. **Is Smithery worth listing on?** Yes — but for completeness, not distribution. It's free, takes about an hour, and offers hosted runtime/auth some users want; measured usage is tiny, though (Context7 shows 6.8K uses there against 1.14M weekly npm downloads). List it; don't report it as a channel. **How do I get into Context7's top results for my category?** Submit your docs site (not your repo) at context7.com/add-library, then write your description to contain the exact category words developers type. DodoPayments ranks #1 for "payments" with a fraction of Stripe's corpus because its description matches the query. Keep the entry fresh — benchmark scores decay with staleness. **Is ClawHub safe to publish skills on?** We recommend skipping it. Researchers confirmed 341 malicious skills distributing the AMOS stealer there (reported Feb 2026; Snyk counted 1,467; estimates run 8–20% of the registry), and the brand-adjacency risk outweighs the reach unless OpenClaw users are specifically your market. **Does Claude Code read the Official MCP Registry?** No. Claude Code's `/mcp` does not browse the official registry; its `/plugin` Discover view ships with Anthropic's claude-plugins-official marketplace instead. Submit to Anthropic's surfaces separately — an official-registry listing does not cover the Claude surface. --- *Last verified 2026-06-11. We re-test the claims on this page quarterly — changes are logged in the [Data Room](/agentic-discovery/data).* **Part of [The Complete Playbook to Agentic Discovery](/agentic-discovery).** ← Previous: [Play 1 — Get Surfaced in Agent Web Search](/agentic-discovery/ai-agent-web-search-and-fetch) · Next: [MCP Server Distribution](/agentic-discovery/mcp-server-distribution) → > **Stay ahead of the agents.** We re-test this playbook quarterly and publish what changed — new data, busted myths, ranking shifts. [Get the update digest →](/agentic-discovery#updates) > > **Want this done for you?** Synscribe runs agentic-discovery programs for B2B SaaS and developer platforms. [Talk to us →](/contact)