[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ECJG51MSJP8DPBYER784ND":3,"skill-same:01M7ECJG51MSJP8DPBYER784ND":49},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":13,"repositoryHtmlUrl":25,"repositoryHomepageUrl":6,"ownerHtmlUrl":26,"ownerBlogUrl":6,"ownerDescription":27,"updatedAt":28,"install":29,"resources":42},"01M7ECJG51MSJP8DPBYER784ND","mcp-registry-publishing",null,"jonahthan433\u002FCortexOS","jonahthan433","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211465495?v=4","01M7ECH9HPHGA89DCXHHJBTS3C","jonah.ai","01M7ECH9JCEM45DZMWPT7148S1",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002F.archive\u002Fmcp-registry-publishing\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# mcp-registry-publishing\n\n# MCP Registry Publishing\n\nHow to get an MCP server listed across the 5 major registries (verified 2026 against primary sources: live API endpoints, official docs, submit pages).\n\n## Compare: submission mechanism by registry\n| Registry | Submission endpoint | Accepts hosted remote URL? |\n|---|---|---|\n| **Official MCP Registry** | `mcp-publisher` CLI; raw API `POST https:\u002F\u002Fregistry.modelcontextprotocol.io\u002Fv0\u002Fpublish` (+ `\u002Fv0\u002Fvalidate` dry-run) | ✅ Native `remotes` Streamable-HTTP entry |\n| **Smithery** | Web form `https:\u002F\u002Fsmithery.ai\u002Fnew` (enter public HTTPS URL); CLI `smithery mcp publish \"\u003Curl>\" -n @org\u002Fserver` | ✅ Primary path now — \"bring your own hosting\", Gateway proxies upstream |\n| **PulseMCP** | Web form `POST \u002Fsubmit` at `pulsemcp.com\u002Fsubmit` (URL uses GitHub repo URL or standalone site) | ✅ Accepts URL directly; also auto-ingests from Official Registry |\n| **mcp.so** | Web form `\u002Fsubmit` — GitHub repo URL (required) + project name | ❌ Submit GitHub repo; remote endpoint indexed from repo\u002FREADME |\n| **Glama** | Web form on `\u002Fmcp\u002Fservers` → \"Add Server\" — GitHub repo URL + name + desc | ⚠️ Entry = open-source GitHub repo; remote endpoints listed once in repo |\n| **apis.guru** | `apis.guru\u002Fadd-api` — the form VALIDATES client-side then composes a **GitHub ISSUE** in `APIs-guru\u002Fopenapi-directory` (`labels=add API`); the maintainers\u002Fbot add the API from the issue. No separate PR step. | ✅ Any valid OpenAPI 3.x JSON at a stable URL |\n\n## Recommended order for a hosted Streamable-HTTP server\n1. **Official MCP Registry first** — publish a `remotes` entry; this auto-ingests you to **PulseMCP**.\n2. **Smithery** via `smithery.ai\u002Fnew` (direct URL; gateway proxies).\n3. Submit the **public GitHub repo** to mcp.so and Glama, with the hosted URL declared in the README\u002Frepo so the remote endpoint gets indexed.\n\n## Core rules\n- Official Registry is **not** the legacy GitHub-Pages `registry.json` PR flow — it's a live service (`github.com\u002Fmodelcontextprotocol\u002Fregistry`) published via the `mcp-publisher` CLI or direct HTTP API. `remotes` entries are JSON per `server.schema.json` (2025-12-11). Registry is preview; breaking changes\u002Fdata resets possible.\n- **Auth == namespace shape (Official Registry).** GitHub OAuth device flow → name must be `io.github.\u003Cuser|org>\u002F*`; DNS TXT auth (`v=MCPv1; k=ed25519|ecdsap384; p=\u003Cpubkey>`) on apex → reverse-DNS `com.example\u002F*`. GitHub org namespace needs Org **Owner** (or PAT with `read:org`); PAT for CI via `\u002Fv0\u002Fauth\u002Fgithub-at`.\n- **Smithery scan pitfall:** its metadata scan getting 403 fails the publish. Don't block automated scans (Cloudflare Bot-Fight Mode); return **401** (not 403) for unauthenticated to trigger OAuth. Auth-wall fallback: static card at `\u002F.well-known\u002Fmcp\u002Fserver-card.json`.\n- Pulsemcp.com and other Cloudflare-protected sites block default curl and headless browser; retry with a browser UA (`-A \"Mozilla\u002F5.0 (X11; Linux x86_64) AppleWebKit\u002F537.36 Chrome\u002F124\"`) — usually passes.\n\n## Pitfalls learned in production (2026-08)\n- **Never `mcp-publisher init` over a crafted server.json.** `init` regenerates the template (`com.example\u002Ftmp`) — publishing that yields 403 \"You have permission to publish: io.github.\u003Cyou>\u002F*. Attempting: com.example\u002Ftmp\". Run `publish server.json` from the project dir; edit the committed file, don't re-init.\n- **`\u002Fv0\u002Fvalidate` is self-documenting.** 422 errors name each missing field verbatim (e.g. \"expected required property $schema\", \"expected length \u003C= 100\" for description). Iterate against it until `{\"valid\":true}` — zero auth needed.\n- **Repository schema gotcha:** `repository` is `{source, url, id}` — no `type` key. `id` = `gh api repos\u002F\u003Cowner>\u002F\u003Crepo> --jq '.id'`. `name` must be `io.github.\u003Cusername>\u002F\u003Cserver>` (slash inside the name).\n- **Read-back requires percent-encoding:** `GET \u002Fv0\u002Fservers\u002F\u003Cname>\u002Fversions` 404s unless the `\u002F` in `io.github.\u003Cuser>\u002F\u003Cserver>` is encoded: `io.github.\u003Cuser>%2F\u003Cserver>`.\n- **GitHub PAT exchange is flaky:** `\u002Fv0\u002Fauth\u002Fgithub-at` with a `ghp_` token succeeded once, then 401'd on every retry (cooldown\u002Fone-shot). The reliable path is interactive `mcp-publisher login github` (device flow, user's browser) — plan for it.\n- **Smithery scan pre-flight:** before submitting, probe the URL with the scan UA so Cloudflare\u002Fbot-fight doesn't fail the publish. Re-runnable probe: `scripts\u002Fsmithery-scan-probe.py \u003Curl>` (expect HTTP 200 + valid `initialize` result).\n\n## Updating an existing listing (hit 2026-08: stale server on Smithery)\n- **Re-publish to the SAME `-n` name = in-place upsert.** `smithery mcp publish \u003Curl> -n \u003Corg>\u002F\u003Cserver>` over an existing name updates the entry — no duplicate, no delete. A URL-based entry proxies your LIVE endpoint, so future changes show up with zero re-publishing (prefer it over repo-based deploys for that reason).\n- **Verify the old endpoint is actually dead before blaming the listing:** `curl -X POST \u003Cold-base>\u002Fmcp` with MCP headers → 404 = old server gone, listing stale; 200 = still live (metadata-only refresh).\n- **Hosted-proxy health probe:** Smithery-proxied servers answer at `https:\u002F\u002F\u003Cserver>--\u003Corg>.run.tools\u002F`. A `401 {\"error\":\"invalid_token\",...}` is HEALTHY — deployed and auth-gated as designed (the platform injects the token). 404 = not deployed. Don't read 401 as failure.\n- **Crawler self-check before submitting:** mcp.so\u002Fglama crawl public servers — check `https:\u002F\u002Fmcp.so\u002Fsearch?q=\u003Cname>` \u002F `https:\u002F\u002Fglama.ai\u002Fmcp\u002Fservers?q=\u003Cname>` first. TRAP: the page echoes your query, so `grep -c \u003Cname>` hits are NOT index hits — read the result-count text (\"No servers match …\" \u002F \"0 results\").\n- **apis.guru logo:** renders `x-logo.url` from the spec — no `x-logo` = logo-less listing. Add `x-logo: {url: \u003Cpublic png>}` + `info.x-apisguru-categories: [\u003Ccat>]` to the spec generator, re-serve, then submit the URL (Glama\u002Fmcp.so read `x-logo` too when they index the spec).\n- **apis.guru add-api = a GitHub issue; submit it directly with `gh`** (2026-08, reverse-engineered from the form's JS). Form's client-side checks: URL path must not be `\u002F` (root → \"specify a machine-readable API definition location, not a website root URL\"), must not end `.html`, no localhost; it probes via `https:\u002F\u002Fcors.redoc.ly\u002F\u003Curl>` and rejects `text\u002Fhtml` content-type. Submission = redirect to `github.com\u002FAPIs-guru\u002Fopenapi-directory\u002Fissues\u002Fnew?labels=add%20API&title=Add \"\u003Cname>\" API&body=\u003Cbody>` where body lines are `**Key**: value` — keys `Format, Official, Url, Name, Category, Logo`. Skip the form entirely:\n  `gh issue create --repo APIs-guru\u002Fopenapi-directory --title 'Add \"CortexCloud\" API' --label 'add API' --body $'**Format**: openapi\\n**Official**: true\\n**Url**: https:\u002F\u002Fapi.cortexcloud.org\u002Fopenapi.json\\n**Name**: CortexCloud\\n**Category**: machine_learning\\n**Logo**: https:\u002F\u002Fapi.cortexcloud.org\u002Fcortex-logo.png'`\n- **apis.guru validator gotchas (each caused a rejection before it was found):** (1) spec MUST have an absolute `servers[].url` — FastAPI's default openapi.json has NO `servers`; inject `spec[\"servers\"]=[{\"url\":\"https:\u002F\u002Fapi.cortexcloud.org\"}]` in the spec generator. (2) `info.x-apisguru-categories` values must be from their valid set — `\"optimization\"` is INVALID and rejected; use `\"ai-ml\"` (or another listed category). Both belong in `update_openapi_v2.py` so the served spec stays directory-ready.\n\n## Official Registry: end-to-end publish flow (verified 2026-08, CortexCloud `io.github.jonahthan433\u002Fcortexcloud`)\n- **npm package is a hard prerequisite.** The registry hosts metadata only — publish the package first. Ownership verification = `mcpName` in package.json (`\"mcpName\": \"io.github.\u003Cuser>\u002F\u003Cserver>\"` — MUST match the `io.github.\u003Cuser>\u002F` prefix for GitHub auth) plus a `repository` field. Scope ownership: the npm account publishing MUST own the scope — E404 `registry.npmjs.org` on publish = logged into the wrong account (fix: `npm whoami` \u002F `npm login`).\n- **Description limit bites TWICE:** the registry rejects `body.description` > 100 chars on `publish` — and the npm package description is checked too. Keep BOTH `server.json.description` and `package.json.description` ≤ 100 chars (verified: 78\u002F88 chars pass).\n- **`mcp-publisher publish` reads the LOCAL `server.json`.** After fixing descriptions in the repo, `git pull` on the publishing machine before re-publishing. Never re-run `init` (it regenerates a `com.example\u002Ftmp` template → 403).\n- **JWT expiry:** `mcp-publisher publish` fails 401 \"invalid or expired Registry JWT\" mid-session; fix is `mcp-publisher login github` (device flow, fresh JWT). DNS timeouts during login = transient, just retry the login.\n- **Read-back verification (working endpoint):** `GET https:\u002F\u002Fregistry.modelcontextprotocol.io\u002Fv0.1\u002Fservers?search=\u003Cname>` — substring search, returns ALL published versions (old ones stay with `_meta.io.modelcontextprotocol.registry\u002Fofficial.isLatest: false`). Per-server GET paths (`\u002Fv0.1\u002Fservers\u002F\u003Cname>` etc.) 404; `\u002Fdocs` → `openapi.yaml` is the API reference.\n- Old versions of your server remain listed as non-latest — harmless; no action needed.\n\n## awesome-mcp-servers (punkpeye) — add a server via PR (verified 2026-08)\n- Flow: `gh repo clone punkpeye\u002Fawesome-mcp-servers` → `gh repo fork --remote=true` (if the fork remote isn't added, `git remote add fork https:\u002F\u002Fgithub.com\u002F\u003Cyou>\u002Fawesome-mcp-servers.git`) → branch → edit README → `git config user.name\u002Fuser.email` (needed: commits fail with \"Author identity unknown\"; use `\u003Cgh-user>@users.noreply.github.com`) → `git push -u fork \u003Cbranch>` → `gh pr create --repo punkpeye\u002Fawesome-mcp-servers --head \u003Cyou>:\u003Cbranch> --title ... --body ...`.\n- Entry format (one line in README): `- [owner\u002Frepo](https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo) \u003Cemoji-tags> - \u003Cdescription with install\u002Fendpoint hints>`. Emoji legend in README: 📇 TypeScript, 🐍 Python, ☁️ remote\u002Fcloud-hosted, 🏠 self-hosted, 🎖️ official. Optional glama badge `[![name MCP server](https:\u002F\u002Fglama.ai\u002Fmcp\u002Fservers\u002FOWNER\u002FREPO\u002Fbadges\u002Fscore.svg)](...)`.\n- Placement: category section (e.g. `### 🧮 Data Science Tools`), roughly alphabetical by owner within section. Remote streamable-http servers: include `☁️` and state the endpoint URL in the description.\n\n## Support\n- `references\u002F2025-2026-mechanism.md` — exact endpoints, required server.json fields, auth flows, per-registry pitfalls.\n",{},"main","38b32c99e7ed0b8e215d638e92cfa452c1ec3079","skills\u002Fimported\u002F.archive\u002Fmcp-registry-publishing","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS","https:\u002F\u002Fgithub.com\u002Fjonahthan433","AI Consultant","2026-10-24 05:13:39",{"source":7,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add jonahthan433\u002FCortexOS --skill mcp-registry-publishing",{"tool":35,"command":36},"bunx","bunx skills add jonahthan433\u002FCortexOS --skill mcp-registry-publishing",{"tool":38,"command":39},"pnpm","pnpm dlx skills add jonahthan433\u002FCortexOS --skill mcp-registry-publishing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002F.archive\u002Fmcp-registry-publishing\u002FSKILL.md",true,[43],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"skill.json","REFERENCE","参考文档",362,"https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002F.archive\u002Fmcp-registry-publishing\u002Fskill.json",[50,56,62,68,74,80],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M7EDQZDQX3Q8Y7GCQX6KN9V7","opportunity-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fsales\u002Fopportunity-brief\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M7EDQYA0V9Y99VKBREJJ3MRT","morning-intel","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fmorning-intel\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7EDQVX1JVY0B6PDHKKGM19G","decision-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fdecision-brief\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7EDQV1GENZAC2SZSD8KZ3GM","weekly-review","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fweekly-review\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7EDQT2KETJ1Y3CGVN9EKW2J","system-health","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fsystem-health\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M7EDQQN2JK3XPWMS1M4T0F3K","backup-restore","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fbackup-restore\u002FSKILL.md",[],[]]