{ "type": "guide", "id": "publish-an-mcp-server", "title": "Publish an MCP server so agents can find it", "summary": "Build a small MCP server with FastMCP, test it with the MCP Inspector CLI, publish its metadata to the official MCP Registry with mcp-publisher, then get it into GitHub's registry, Glama, Smithery, the Docker MCP Catalog and Index Agentica.", "author": "Agentica Author", "tags": [ "mcp", "mcp-registry", "publishing", "discovery", "fastmcp", "mcp-inspector", "streamable-http" ], "published": "2026-10-17", "last_verified": "2026-10-17", "difficulty": "intermediate", "time_estimate": "45 min", "entries": [ "fastmcp", "mcp-inspector", "official-mcp-registry", "github-mcp-registry", "glama-mcp", "smithery", "docker-mcp-catalog", "model-context-protocol", "mcp-authorization", "indexagentica-mcp" ], "links": { "html": "https://indexagentica.com/guides/publish-an-mcp-server/", "markdown": "https://indexagentica.com/guides/publish-an-mcp-server.md", "json": "https://indexagentica.com/api/longform/guides/publish-an-mcp-server.json", "source": "https://github.com/Drudley/indexagentica/blob/main/content-long/guides/publish-an-mcp-server.md" }, "status": "published", "prerequisites": [ "Python 3.10 or later and uv (for FastMCP)", "Node.js 22.19 or later (for the MCP Inspector)", "A GitHub account, or a domain whose DNS or web root you control", "A public HTTPS host for a remote server, or an account on npm, PyPI or a container registry for a package" ], "entries_detail": [ { "id": "fastmcp", "name": "FastMCP", "summary": "The fast, Pythonic framework for building MCP servers, clients and interactive applications.", "url": "https://indexagentica.com/entries/fastmcp/", "json": "https://indexagentica.com/api/entries/fastmcp.json" }, { "id": "mcp-inspector", "name": "MCP Inspector", "summary": "Official interactive developer tool for testing and debugging MCP servers in the browser, on the command line or in the terminal.", "url": "https://indexagentica.com/entries/mcp-inspector/", "json": "https://indexagentica.com/api/entries/mcp-inspector.json" }, { "id": "official-mcp-registry", "name": "Official MCP Registry", "summary": "Community-driven registry service from the MCP project listing published MCP servers, with a public REST API (like an app store for MCP servers).", "url": "https://indexagentica.com/entries/official-mcp-registry/", "json": "https://indexagentica.com/api/entries/official-mcp-registry.json" }, { "id": "github-mcp-registry", "name": "GitHub MCP Registry", "summary": "GitHub's registry centralizing MCP servers for discovery and integration with GitHub Copilot and other tools.", "url": "https://indexagentica.com/entries/github-mcp-registry/", "json": "https://indexagentica.com/api/entries/github-mcp-registry.json" }, { "id": "glama-mcp", "name": "Glama MCP Directory", "summary": "Large directory of MCP servers, clients and remote connectors, each scanned, scored and testable in the browser, with a public API.", "url": "https://indexagentica.com/entries/glama-mcp/", "json": "https://indexagentica.com/api/entries/glama-mcp.json" }, { "id": "smithery", "name": "Smithery", "summary": "Platform for connecting agents to thousands of tools and services (MCP), with auth, credentials and sessions handled for you.", "url": "https://indexagentica.com/entries/smithery/", "json": "https://indexagentica.com/api/entries/smithery.json" }, { "id": "docker-mcp-catalog", "name": "Docker MCP Catalog", "summary": "Docker Hub's catalog of containerized, ready-to-use MCP servers, backed by the open docker/mcp-registry repo.", "url": "https://indexagentica.com/entries/docker-mcp-catalog/", "json": "https://indexagentica.com/api/entries/docker-mcp-catalog.json" }, { "id": "model-context-protocol", "name": "Model Context Protocol (MCP)", "summary": "Open protocol that standardizes how AI applications connect to external tools, data sources and prompts via MCP servers.", "url": "https://indexagentica.com/entries/model-context-protocol/", "json": "https://indexagentica.com/api/entries/model-context-protocol.json" }, { "id": "mcp-authorization", "name": "MCP Authorization (OAuth 2.1 for MCP)", "summary": "The MCP specification's transport-level authorization flow for HTTP-based MCP servers, based on a subset of OAuth 2.1 and related RFCs.", "url": "https://indexagentica.com/entries/mcp-authorization/", "json": "https://indexagentica.com/api/entries/mcp-authorization.json" }, { "id": "indexagentica-mcp", "name": "Index Agentica MCP Server", "summary": "Remote, read-only MCP server for searching this directory (Index Agentica): search, get_entry, get_content and list_categories over Streamable HTTP, no auth.", "url": "https://indexagentica.com/entries/indexagentica-mcp/", "json": "https://indexagentica.com/api/entries/indexagentica-mcp.json" } ], "related": [ { "type": "guide", "id": "add-oauth-to-your-mcp-server", "title": "Add OAuth authorization to your own MCP server", "url": "https://indexagentica.com/guides/add-oauth-to-your-mcp-server/", "json": "https://indexagentica.com/api/longform/guides/add-oauth-to-your-mcp-server.json" }, { "type": "guide", "id": "connect-an-agent-to-a-remote-mcp-server", "title": "Connect an agent to a remote MCP server", "url": "https://indexagentica.com/guides/connect-an-agent-to-a-remote-mcp-server/", "json": "https://indexagentica.com/api/longform/guides/connect-an-agent-to-a-remote-mcp-server.json" }, { "type": "guide", "id": "agent-auth-and-delegated-access", "title": "Agent auth and delegated access, step by step", "url": "https://indexagentica.com/guides/agent-auth-and-delegated-access/", "json": "https://indexagentica.com/api/longform/guides/agent-auth-and-delegated-access.json" }, { "type": "comparison", "id": "agent-identity-and-mcp-auth", "title": "Agent identity and MCP authorization platforms", "url": "https://indexagentica.com/compare/agent-identity-and-mcp-auth/", "json": "https://indexagentica.com/api/longform/compare/agent-identity-and-mcp-auth.json" }, { "type": "skill", "id": "pick-an-mcp-server", "title": "Pick an MCP server", "url": "https://indexagentica.com/skills/pick-an-mcp-server/", "json": "https://indexagentica.com/api/longform/skills/pick-an-mcp-server.json" }, { "type": "guide", "id": "add-mcp-servers-to-claude-code", "title": "Add MCP servers to Claude Code", "url": "https://indexagentica.com/guides/add-mcp-servers-to-claude-code/", "json": "https://indexagentica.com/api/longform/guides/add-mcp-servers-to-claude-code.json" }, { "type": "guide", "id": "test-your-mcp-server", "title": "Test your MCP server with in-process tests and Inspector CI checks", "url": "https://indexagentica.com/guides/test-your-mcp-server/", "json": "https://indexagentica.com/api/longform/guides/test-your-mcp-server.json" }, { "type": "comparison", "id": "mcp-gateways", "title": "MCP gateways compared", "url": "https://indexagentica.com/compare/mcp-gateways/", "json": "https://indexagentica.com/api/longform/compare/mcp-gateways.json" } ], "sources": [ { "title": "FastMCP installation", "url": "https://gofastmcp.com/getting-started/installation", "accessed": "2026-10-17" }, { "title": "FastMCP quickstart", "url": "https://gofastmcp.com/getting-started/quickstart", "accessed": "2026-10-17" }, { "title": "FastMCP HTTP deployment", "url": "https://gofastmcp.com/deployment/http", "accessed": "2026-10-17" }, { "title": "fastmcp on PyPI", "url": "https://pypi.org/project/fastmcp/", "accessed": "2026-10-17" }, { "title": "MCP Inspector README", "url": "https://github.com/modelcontextprotocol/inspector", "accessed": "2026-10-17" }, { "title": "MCP Inspector CLI README", "url": "https://github.com/modelcontextprotocol/inspector/blob/main/clients/cli/README.md", "accessed": "2026-10-17" }, { "title": "Quickstart: Publish an MCP server to the MCP Registry", "url": "https://modelcontextprotocol.io/registry/quickstart", "accessed": "2026-10-17" }, { "title": "MCP Registry authentication", "url": "https://modelcontextprotocol.io/registry/authentication", "accessed": "2026-10-17" }, { "title": "MCP Registry package types", "url": "https://modelcontextprotocol.io/registry/package-types", "accessed": "2026-10-17" }, { "title": "Publishing remote servers to the MCP Registry", "url": "https://modelcontextprotocol.io/registry/remote-servers", "accessed": "2026-10-17" }, { "title": "Versioning published MCP servers", "url": "https://modelcontextprotocol.io/registry/versioning", "accessed": "2026-10-17" }, { "title": "Publishing to the MCP Registry with GitHub Actions", "url": "https://modelcontextprotocol.io/registry/github-actions", "accessed": "2026-10-17" }, { "title": "MCP Registry aggregators", "url": "https://modelcontextprotocol.io/registry/registry-aggregators", "accessed": "2026-10-17" }, { "title": "MCP Registry FAQ", "url": "https://modelcontextprotocol.io/registry/faq", "accessed": "2026-10-17" }, { "title": "GitHub blog: How to find, install, and manage MCP servers with the GitHub MCP Registry", "url": "https://github.blog/ai-and-ml/generative-ai/how-to-find-install-and-manage-mcp-servers-with-the-github-mcp-registry/", "accessed": "2026-10-17" }, { "title": "github/github-mcp-server discussion #1257 (GitHub MCP Registry onboarding)", "url": "https://github.com/github/github-mcp-server/discussions/1257", "accessed": "2026-10-17" }, { "title": "Glama llms.txt", "url": "https://glama.ai/llms.txt", "accessed": "2026-10-17" }, { "title": "Glama glama.json schema", "url": "https://glama.ai/mcp/schemas/server.json", "accessed": "2026-10-17" }, { "title": "Glama connector ownership schema", "url": "https://glama.ai/mcp/schemas/connector.json", "accessed": "2026-10-17" }, { "title": "Smithery, Publish", "url": "https://smithery.ai/docs/build/publish", "accessed": "2026-10-17" }, { "title": "Docker MCP Registry README", "url": "https://github.com/docker/mcp-registry", "accessed": "2026-10-17" }, { "title": "Contributing to the Docker MCP Registry", "url": "https://github.com/docker/mcp-registry/blob/main/CONTRIBUTING.md", "accessed": "2026-10-17" }, { "title": "Index Agentica contribute.json", "url": "https://indexagentica.com/contribute.json", "accessed": "2026-10-17" } ], "front_matter": { "id": "publish-an-mcp-server", "type": "guide", "title": "Publish an MCP server so agents can find it", "summary": "Build a small MCP server with FastMCP, test it with the MCP Inspector CLI, publish its metadata to the official MCP Registry with mcp-publisher, then get it into GitHub's registry, Glama, Smithery, the Docker MCP Catalog and Index Agentica.", "description": "A practical path from a working MCP server to a discoverable one. It builds and runs a FastMCP server over Streamable HTTP, checks it with the MCP Inspector CLI, explains hosting and packaging choices, walks through server.json, namespace authentication and publishing on the official MCP Registry, and lists what each downstream directory needs. Steps come from each project's docs, checked on 2026-10-17. The build and test commands were run; nothing was published.", "author": "Agentica Author", "difficulty": "intermediate", "time_estimate": "45 min", "prerequisites": [ "Python 3.10 or later and uv (for FastMCP)", "Node.js 22.19 or later (for the MCP Inspector)", "A GitHub account, or a domain whose DNS or web root you control", "A public HTTPS host for a remote server, or an account on npm, PyPI or a container registry for a package" ], "tags": [ "mcp", "mcp-registry", "publishing", "discovery", "fastmcp", "mcp-inspector", "streamable-http" ], "entries": [ "fastmcp", "mcp-inspector", "official-mcp-registry", "github-mcp-registry", "glama-mcp", "smithery", "docker-mcp-catalog", "model-context-protocol", "mcp-authorization", "indexagentica-mcp" ], "sources": [ { "title": "FastMCP installation", "url": "https://gofastmcp.com/getting-started/installation", "accessed": "2026-10-17" }, { "title": "FastMCP quickstart", "url": "https://gofastmcp.com/getting-started/quickstart", "accessed": "2026-10-17" }, { "title": "FastMCP HTTP deployment", "url": "https://gofastmcp.com/deployment/http", "accessed": "2026-10-17" }, { "title": "fastmcp on PyPI", "url": "https://pypi.org/project/fastmcp/", "accessed": "2026-10-17" }, { "title": "MCP Inspector README", "url": "https://github.com/modelcontextprotocol/inspector", "accessed": "2026-10-17" }, { "title": "MCP Inspector CLI README", "url": "https://github.com/modelcontextprotocol/inspector/blob/main/clients/cli/README.md", "accessed": "2026-10-17" }, { "title": "Quickstart: Publish an MCP server to the MCP Registry", "url": "https://modelcontextprotocol.io/registry/quickstart", "accessed": "2026-10-17" }, { "title": "MCP Registry authentication", "url": "https://modelcontextprotocol.io/registry/authentication", "accessed": "2026-10-17" }, { "title": "MCP Registry package types", "url": "https://modelcontextprotocol.io/registry/package-types", "accessed": "2026-10-17" }, { "title": "Publishing remote servers to the MCP Registry", "url": "https://modelcontextprotocol.io/registry/remote-servers", "accessed": "2026-10-17" }, { "title": "Versioning published MCP servers", "url": "https://modelcontextprotocol.io/registry/versioning", "accessed": "2026-10-17" }, { "title": "Publishing to the MCP Registry with GitHub Actions", "url": "https://modelcontextprotocol.io/registry/github-actions", "accessed": "2026-10-17" }, { "title": "MCP Registry aggregators", "url": "https://modelcontextprotocol.io/registry/registry-aggregators", "accessed": "2026-10-17" }, { "title": "MCP Registry FAQ", "url": "https://modelcontextprotocol.io/registry/faq", "accessed": "2026-10-17" }, { "title": "GitHub blog: How to find, install, and manage MCP servers with the GitHub MCP Registry", "url": "https://github.blog/ai-and-ml/generative-ai/how-to-find-install-and-manage-mcp-servers-with-the-github-mcp-registry/", "accessed": "2026-10-17" }, { "title": "github/github-mcp-server discussion #1257 (GitHub MCP Registry onboarding)", "url": "https://github.com/github/github-mcp-server/discussions/1257", "accessed": "2026-10-17" }, { "title": "Glama llms.txt", "url": "https://glama.ai/llms.txt", "accessed": "2026-10-17" }, { "title": "Glama glama.json schema", "url": "https://glama.ai/mcp/schemas/server.json", "accessed": "2026-10-17" }, { "title": "Glama connector ownership schema", "url": "https://glama.ai/mcp/schemas/connector.json", "accessed": "2026-10-17" }, { "title": "Smithery, Publish", "url": "https://smithery.ai/docs/build/publish", "accessed": "2026-10-17" }, { "title": "Docker MCP Registry README", "url": "https://github.com/docker/mcp-registry", "accessed": "2026-10-17" }, { "title": "Contributing to the Docker MCP Registry", "url": "https://github.com/docker/mcp-registry/blob/main/CONTRIBUTING.md", "accessed": "2026-10-17" }, { "title": "Index Agentica contribute.json", "url": "https://indexagentica.com/contribute.json", "accessed": "2026-10-17" } ], "related": [ "add-oauth-to-your-mcp-server", "connect-an-agent-to-a-remote-mcp-server", "agent-auth-and-delegated-access", "agent-identity-and-mcp-auth", "pick-an-mcp-server", "add-mcp-servers-to-claude-code", "test-your-mcp-server", "mcp-gateways" ], "last_verified": "2026-10-17", "published": "2026-10-17" }, "markdown": "\nA working MCP server is only half the job. Agents and their humans find servers through registries and directories, and most of those now read from one place: the [official MCP Registry](https://indexagentica.com/entries/official-mcp-registry/). This guide takes a small server from code to a published listing, then covers the directories that sit downstream.\n\nWhat was actually run for this guide, on 2026-10-17: the FastMCP server below (FastMCP 4.1.0), the MCP Inspector CLI calls against it over HTTP and stdio (Inspector 2.11.0), and `mcp-publisher validate` on the example `server.json`. Nothing was published to any registry.\n\n```mermaid\nflowchart LR\n A[Build: FastMCP] --> B[Test: MCP Inspector]\n B --> C{Ship how?}\n C -->|remote| D[Host over Streamable HTTP]\n C -->|local| E[Publish package: npm / PyPI / OCI]\n D --> F[server.json + mcp-publisher]\n E --> F\n F --> G[Official MCP Registry]\n G --> H[GitHub MCP Registry, Glama, other aggregators]\n D --> I[Smithery, Docker MCP Catalog, Index Agentica]\n```\n\n## 1. Build a small server with FastMCP\n\n[FastMCP](https://indexagentica.com/entries/fastmcp/) is a Python framework for MCP servers. Install it with `uv add fastmcp` or `pip install fastmcp` (it needs Python 3.10 or later), and check with `fastmcp version`.\n\nA tool is a decorated function. Type hints become the input schema and the docstring becomes the description that agents read, so write it for them:\n\n```python\n# server.py\nfrom fastmcp import FastMCP\n\nmcp = FastMCP(\"Unit Converter\")\n\n@mcp.tool\ndef km_to_miles(km: float) -> float:\n \"\"\"Convert kilometres to miles.\"\"\"\n return round(km * 0.621371, 4)\n\nif __name__ == \"__main__\":\n mcp.run(transport=\"http\", host=\"127.0.0.1\", port=8765)\n```\n\nRun it with `python server.py`. With the HTTP transport the endpoint is at `/mcp`, here `http://127.0.0.1:8765/mcp`. Calling `mcp.run()` with no arguments uses stdio instead, which is what local, package-based installs use. The CLI can choose at launch: `fastmcp run server.py:mcp --transport http --port 8000`.\n\n## 2. Test it with the MCP Inspector\n\nThe [MCP Inspector](https://indexagentica.com/entries/mcp-inspector/) has a web UI (`npx @modelcontextprotocol/inspector`), a TUI (`--tui`) and a scriptable CLI (`--cli`). The CLI is the one to use from an agent or in CI:\n\n```bash\n# List tools (a URL ending in /mcp means Streamable HTTP)\nnpx @modelcontextprotocol/inspector --cli http://127.0.0.1:8765/mcp --method tools/list\n\n# Call one\nnpx @modelcontextprotocol/inspector --cli http://127.0.0.1:8765/mcp \\\n --method tools/call --tool-name km_to_miles --tool-arg km=42\n```\n\nAgainst the server above, the call returned `\"structuredContent\": {\"result\": 26.0976}` and `\"isError\": false`. `tools/list` showed the `km` input schema and an output schema that FastMCP generated from the return type. Other useful methods are `initialize` (a connect-only probe), `resources/list` and `prompts/list`. For stdio, pass a command instead of a URL. For example, `--cli fastmcp run server.py:mcp` starts the same server over stdio, because the FastMCP CLI ignores the `__main__` block. Add `--header \"X-API-Key: ...\"` for an authenticated remote.\n\nThe Inspector stores OAuth tokens and stdio `env:` secrets in the OS keychain. On a machine without one, such as a headless Linux box or a container, they go to `~/.mcp-inspector/secrets.json`, unencrypted unless you supply a key.\n\n## 3. Decide how it ships: remote or package\n\nThe registry lists two kinds of install, and one server can offer both.\n\n**Remote (hosted) server.** Clients connect to a URL, and nothing is installed. Remote servers should use Streamable HTTP; SSE is deprecated and worth publishing only for existing clients. For production, FastMCP can give you an ASGI app to run under Uvicorn or similar:\n\n```python\napp = mcp.http_app() # serve with: uvicorn server:app --host 0.0.0.0 --port 8000\n```\n\nFastMCP's deployment guide calls authentication \"highly recommended\" for remote servers and notes that some clients refuse to connect without it. Bearer tokens, JWT and OAuth are covered in its auth docs, and the protocol side is in [MCP authorization](https://indexagentica.com/entries/mcp-authorization/). The guide also documents an opt-in Host and Origin check against DNS rebinding (`host_origin_protection=True` with `allowed_hosts`). It is off by default, so turn it on or enforce the same checks in your reverse proxy. For managed hosting, the FastMCP docs point to Prefect Horizon, which they describe as free for personal projects.\n\n**Package (local) server.** Users run it with `npx`, `uvx`, `dnx`, Docker and similar tools. The registry hosts only metadata, so publish the package first. Each package type proves that it belongs to your registry name differently:\n\n| Package type | `registryType` | Ownership marker |\n|---|---|---|\n| npm | `npm` | `\"mcpName\": \"\"` in `package.json` |\n| PyPI | `pypi` | `mcp-name: ` in the README, which can be hidden in an HTML comment |\n| NuGet | `nuget` | `mcp-name: ` in the README |\n| Cargo | `cargo` | `mcp-name: ` as visible text, because crates.io strips HTML comments |\n| Docker/OCI | `oci` | `io.modelcontextprotocol.server.name` annotation on the image |\n\n## 4. Publish to the official MCP Registry\n\nThe registry is in preview, and its docs warn that breaking changes or data resets may happen before general availability.\n\n**Install the publisher** (a prebuilt binary, or `brew install mcp-publisher`):\n\n```bash\ncurl -L \"https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz\" | tar xz mcp-publisher\n```\n\n**Write `server.json`.** `mcp-publisher init` makes a template from your project. For a remote-only server, replace the generated `packages` array with `remotes`:\n\n```json\n{\n \"$schema\": \"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json\",\n \"name\": \"io.github.your-username/unit-converter\",\n \"title\": \"Unit Converter\",\n \"description\": \"Converts kilometres to miles. A minimal example remote MCP server.\",\n \"repository\": { \"url\": \"https://github.com/your-username/unit-converter-mcp\", \"source\": \"github\" },\n \"version\": \"1.0.0\",\n \"remotes\": [\n { \"type\": \"streamable-http\", \"url\": \"https://mcp.example.com/mcp\" }\n ]\n}\n```\n\nRules worth knowing before you publish:\n\n- `description` is limited to 100 characters.\n- A remote URL must be publicly reachable, and each URL can belong to only one server name.\n- Remotes can declare required `headers` (such as an API key marked `isSecret`) and URL template `variables` (such as `{tenant_id}`), and they can sit alongside `packages`.\n- Each publish needs a new, unique `version`. Published metadata is immutable, so you fix mistakes by publishing a new version. Semantic versions are recommended, and version ranges are rejected.\n- Custom data goes under `_meta.io.modelcontextprotocol.registry/publisher-provided`, up to 4 KB.\n\nRun `mcp-publisher validate` to check the file without publishing.\n\n**Authenticate.** The method decides which names you may use:\n\n| Method | Command | Names you can publish |\n|---|---|---|\n| GitHub OAuth | `mcp-publisher login github` (device code) | `io.github./*`, or `io.github./*` only if you are an **Owner** of the org |\n| DNS | `mcp-publisher login dns --domain example.com --private-key ...` | `com.example/*` and subdomains, with an Ed25519 or ECDSA P-384 key in a TXT record on the domain **apex** |\n| HTTP | `mcp-publisher login http --domain example.com --private-key ...` | `com.example/*`, with the public key at `https://example.com/.well-known/mcp-registry-auth` |\n| GitHub Actions | `mcp-publisher login github-oidc` (the docs' recommended CI option; the job needs `id-token: write`) | The example workflow publishes on version tags without a stored token; PAT and DNS logins also work in CI |\n\nThe registry checks that you control the namespace, not the remote URL. If the server runs on your own domain, use DNS or HTTP auth so the name and the URL visibly belong to the same publisher.\n\n**Publish and verify:**\n\n```bash\nmcp-publisher publish\ncurl \"https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.your-username/unit-converter\"\n```\n\nTo retire a version, run `mcp-publisher status --status deleted --message \"...\" `, or add `--all-versions`. Deleted entries are hidden from default listings but never removed, and setting the status back to `active` restores them.\n\n## 5. Get into the downstream directories\n\nThe registry exposes an unauthenticated read API that aggregators are expected to poll about hourly, so some directories pick your server up from there. Others need a step from you.\n\n| Directory | How a server gets in |\n|---|---|\n| [GitHub MCP Registry](https://indexagentica.com/entries/github-mcp-registry/) | Publish to the official registry first (status `active`, latest). Adding a new server to github.com/mcp is a manual curation step: GitHub's blog says to email partnerships@github.com, and requests are also posted in discussion #1257. After onboarding, new versions sync automatically. Check with `curl \"https://api.mcp.github.com/v0.1/servers?search=\"`. |\n| [Glama](https://indexagentica.com/entries/glama-mcp/) | Indexes servers from GitHub, the official registry and community submissions, then scans and scores them. To claim a repository listing, commit a `glama.json` with `maintainers` (GitHub usernames). To claim a remote connector, serve `/.well-known/glama.json` with the claim token from Glama's claim panel on your domain. |\n| [Smithery](https://indexagentica.com/entries/smithery/) | Go to smithery.ai/new and enter your public HTTPS URL, or use `smithery mcp publish \"\" -n @org/server`. It requires Streamable HTTP and OAuth if your server needs auth. If Smithery's scan can't read your tools, serve a static card at `/.well-known/mcp/server-card.json`. |\n| [Docker MCP Catalog](https://indexagentica.com/entries/docker-mcp-catalog/) | Open a pull request on `docker/mcp-registry` with `servers//server.yaml`, made with `task wizard` or `task create`, or `task remote-wizard` for remote servers. The Docker team reviews every PR. After approval, a Docker-built image is signed and published under `mcp/` on Docker Hub, and the entry appears within 24 hours. |\n| Index Agentica | Open a pull request adding `content/mcp-servers/.json`, or use the structured New entry issue. A maintainer reviews it, and `contribute.json` has the schema and rules. Agents are welcome to submit, as long as they say they are an agent and who they act for. Our own server is listed as [indexagentica-mcp](https://indexagentica.com/entries/indexagentica-mcp/). |\n\n## Checklist\n\n- [ ] Tool names and docstrings tell an agent when to use each tool.\n- [ ] `tools/list` and a real `tools/call` pass in the Inspector CLI, ideally in CI.\n- [ ] Remote: Streamable HTTP, authentication on, Host/Origin checks on (in FastMCP or your proxy), HTTPS.\n- [ ] Package: the ownership marker matches the `server.json` name exactly.\n- [ ] `server.json` passes `mcp-publisher validate`; the description fits in 100 characters; the version is new.\n- [ ] You published under a namespace you control (GitHub user or org you own, or your domain).\n- [ ] You requested GitHub onboarding, claimed the Glama listing, and submitted to Smithery, Docker and Index Agentica if they fit.\n\n## Troubleshooting (from the registry docs)\n\n| Error | Fix |\n|---|---|\n| \"Registry validation failed for package\" | The ownership marker is missing or doesn't match (`mcpName`, `mcp-name:` or the OCI annotation). |\n| \"Invalid or expired Registry JWT token\" | Log in again with `mcp-publisher login ...`. |\n| \"You do not have permission to publish this server\" | The name doesn't match your auth method, for example a GitHub login publishing outside `io.github./`. |\n| DNS auth fails with a signature error | The TXT record must be on the apex, not under a selector, and stale records from old keys must be removed. |\n\nOnce you're listed, the other side of the flow is in [Connect an agent to a remote MCP server](https://indexagentica.com/guides/connect-an-agent-to-a-remote-mcp-server/). For auth design, see [Agent auth and delegated access](https://indexagentica.com/guides/agent-auth-and-delegated-access/).\n", "raw": "---\nid: publish-an-mcp-server\ntype: guide\ntitle: Publish an MCP server so agents can find it\nsummary: \"Build a small MCP server with FastMCP, test it with the MCP Inspector CLI, publish its metadata to the official MCP Registry with mcp-publisher, then get it into GitHub's registry, Glama, Smithery, the Docker MCP Catalog and Index Agentica.\"\ndescription: \"A practical path from a working MCP server to a discoverable one. It builds and runs a FastMCP server over Streamable HTTP, checks it with the MCP Inspector CLI, explains hosting and packaging choices, walks through server.json, namespace authentication and publishing on the official MCP Registry, and lists what each downstream directory needs. Steps come from each project's docs, checked on 2026-10-17. The build and test commands were run; nothing was published.\"\nauthor: Agentica Author\ndifficulty: intermediate\ntime_estimate: 45 min\nprerequisites:\n - Python 3.10 or later and uv (for FastMCP)\n - Node.js 22.19 or later (for the MCP Inspector)\n - A GitHub account, or a domain whose DNS or web root you control\n - A public HTTPS host for a remote server, or an account on npm, PyPI or a container registry for a package\ntags: [mcp, mcp-registry, publishing, discovery, fastmcp, mcp-inspector, streamable-http]\nentries: [fastmcp, mcp-inspector, official-mcp-registry, github-mcp-registry, glama-mcp, smithery, docker-mcp-catalog, model-context-protocol, mcp-authorization, indexagentica-mcp]\nsources:\n - title: FastMCP installation\n url: https://gofastmcp.com/getting-started/installation\n accessed: 2026-10-17\n - title: FastMCP quickstart\n url: https://gofastmcp.com/getting-started/quickstart\n accessed: 2026-10-17\n - title: FastMCP HTTP deployment\n url: https://gofastmcp.com/deployment/http\n accessed: 2026-10-17\n - title: fastmcp on PyPI\n url: https://pypi.org/project/fastmcp/\n accessed: 2026-10-17\n - title: MCP Inspector README\n url: https://github.com/modelcontextprotocol/inspector\n accessed: 2026-10-17\n - title: MCP Inspector CLI README\n url: https://github.com/modelcontextprotocol/inspector/blob/main/clients/cli/README.md\n accessed: 2026-10-17\n - title: \"Quickstart: Publish an MCP server to the MCP Registry\"\n url: https://modelcontextprotocol.io/registry/quickstart\n accessed: 2026-10-17\n - title: MCP Registry authentication\n url: https://modelcontextprotocol.io/registry/authentication\n accessed: 2026-10-17\n - title: MCP Registry package types\n url: https://modelcontextprotocol.io/registry/package-types\n accessed: 2026-10-17\n - title: Publishing remote servers to the MCP Registry\n url: https://modelcontextprotocol.io/registry/remote-servers\n accessed: 2026-10-17\n - title: Versioning published MCP servers\n url: https://modelcontextprotocol.io/registry/versioning\n accessed: 2026-10-17\n - title: Publishing to the MCP Registry with GitHub Actions\n url: https://modelcontextprotocol.io/registry/github-actions\n accessed: 2026-10-17\n - title: MCP Registry aggregators\n url: https://modelcontextprotocol.io/registry/registry-aggregators\n accessed: 2026-10-17\n - title: MCP Registry FAQ\n url: https://modelcontextprotocol.io/registry/faq\n accessed: 2026-10-17\n - title: \"GitHub blog: How to find, install, and manage MCP servers with the GitHub MCP Registry\"\n url: https://github.blog/ai-and-ml/generative-ai/how-to-find-install-and-manage-mcp-servers-with-the-github-mcp-registry/\n accessed: 2026-10-17\n - title: \"github/github-mcp-server discussion #1257 (GitHub MCP Registry onboarding)\"\n url: https://github.com/github/github-mcp-server/discussions/1257\n accessed: 2026-10-17\n - title: Glama llms.txt\n url: https://glama.ai/llms.txt\n accessed: 2026-10-17\n - title: Glama glama.json schema\n url: https://glama.ai/mcp/schemas/server.json\n accessed: 2026-10-17\n - title: Glama connector ownership schema\n url: https://glama.ai/mcp/schemas/connector.json\n accessed: 2026-10-17\n - title: Smithery, Publish\n url: https://smithery.ai/docs/build/publish\n accessed: 2026-10-17\n - title: Docker MCP Registry README\n url: https://github.com/docker/mcp-registry\n accessed: 2026-10-17\n - title: Contributing to the Docker MCP Registry\n url: https://github.com/docker/mcp-registry/blob/main/CONTRIBUTING.md\n accessed: 2026-10-17\n - title: Index Agentica contribute.json\n url: https://indexagentica.com/contribute.json\n accessed: 2026-10-17\nrelated: [add-oauth-to-your-mcp-server, connect-an-agent-to-a-remote-mcp-server, agent-auth-and-delegated-access, agent-identity-and-mcp-auth, pick-an-mcp-server, add-mcp-servers-to-claude-code, test-your-mcp-server, mcp-gateways]\nlast_verified: 2026-10-17\npublished: 2026-10-17\n---\n\nA working MCP server is only half the job. Agents and their humans find servers through registries and directories, and most of those now read from one place: the [official MCP Registry](https://indexagentica.com/entries/official-mcp-registry/). This guide takes a small server from code to a published listing, then covers the directories that sit downstream.\n\nWhat was actually run for this guide, on 2026-10-17: the FastMCP server below (FastMCP 4.1.0), the MCP Inspector CLI calls against it over HTTP and stdio (Inspector 2.11.0), and `mcp-publisher validate` on the example `server.json`. Nothing was published to any registry.\n\n```mermaid\nflowchart LR\n A[Build: FastMCP] --> B[Test: MCP Inspector]\n B --> C{Ship how?}\n C -->|remote| D[Host over Streamable HTTP]\n C -->|local| E[Publish package: npm / PyPI / OCI]\n D --> F[server.json + mcp-publisher]\n E --> F\n F --> G[Official MCP Registry]\n G --> H[GitHub MCP Registry, Glama, other aggregators]\n D --> I[Smithery, Docker MCP Catalog, Index Agentica]\n```\n\n## 1. Build a small server with FastMCP\n\n[FastMCP](https://indexagentica.com/entries/fastmcp/) is a Python framework for MCP servers. Install it with `uv add fastmcp` or `pip install fastmcp` (it needs Python 3.10 or later), and check with `fastmcp version`.\n\nA tool is a decorated function. Type hints become the input schema and the docstring becomes the description that agents read, so write it for them:\n\n```python\n# server.py\nfrom fastmcp import FastMCP\n\nmcp = FastMCP(\"Unit Converter\")\n\n@mcp.tool\ndef km_to_miles(km: float) -> float:\n \"\"\"Convert kilometres to miles.\"\"\"\n return round(km * 0.621371, 4)\n\nif __name__ == \"__main__\":\n mcp.run(transport=\"http\", host=\"127.0.0.1\", port=8765)\n```\n\nRun it with `python server.py`. With the HTTP transport the endpoint is at `/mcp`, here `http://127.0.0.1:8765/mcp`. Calling `mcp.run()` with no arguments uses stdio instead, which is what local, package-based installs use. The CLI can choose at launch: `fastmcp run server.py:mcp --transport http --port 8000`.\n\n## 2. Test it with the MCP Inspector\n\nThe [MCP Inspector](https://indexagentica.com/entries/mcp-inspector/) has a web UI (`npx @modelcontextprotocol/inspector`), a TUI (`--tui`) and a scriptable CLI (`--cli`). The CLI is the one to use from an agent or in CI:\n\n```bash\n# List tools (a URL ending in /mcp means Streamable HTTP)\nnpx @modelcontextprotocol/inspector --cli http://127.0.0.1:8765/mcp --method tools/list\n\n# Call one\nnpx @modelcontextprotocol/inspector --cli http://127.0.0.1:8765/mcp \\\n --method tools/call --tool-name km_to_miles --tool-arg km=42\n```\n\nAgainst the server above, the call returned `\"structuredContent\": {\"result\": 26.0976}` and `\"isError\": false`. `tools/list` showed the `km` input schema and an output schema that FastMCP generated from the return type. Other useful methods are `initialize` (a connect-only probe), `resources/list` and `prompts/list`. For stdio, pass a command instead of a URL. For example, `--cli fastmcp run server.py:mcp` starts the same server over stdio, because the FastMCP CLI ignores the `__main__` block. Add `--header \"X-API-Key: ...\"` for an authenticated remote.\n\nThe Inspector stores OAuth tokens and stdio `env:` secrets in the OS keychain. On a machine without one, such as a headless Linux box or a container, they go to `~/.mcp-inspector/secrets.json`, unencrypted unless you supply a key.\n\n## 3. Decide how it ships: remote or package\n\nThe registry lists two kinds of install, and one server can offer both.\n\n**Remote (hosted) server.** Clients connect to a URL, and nothing is installed. Remote servers should use Streamable HTTP; SSE is deprecated and worth publishing only for existing clients. For production, FastMCP can give you an ASGI app to run under Uvicorn or similar:\n\n```python\napp = mcp.http_app() # serve with: uvicorn server:app --host 0.0.0.0 --port 8000\n```\n\nFastMCP's deployment guide calls authentication \"highly recommended\" for remote servers and notes that some clients refuse to connect without it. Bearer tokens, JWT and OAuth are covered in its auth docs, and the protocol side is in [MCP authorization](https://indexagentica.com/entries/mcp-authorization/). The guide also documents an opt-in Host and Origin check against DNS rebinding (`host_origin_protection=True` with `allowed_hosts`). It is off by default, so turn it on or enforce the same checks in your reverse proxy. For managed hosting, the FastMCP docs point to Prefect Horizon, which they describe as free for personal projects.\n\n**Package (local) server.** Users run it with `npx`, `uvx`, `dnx`, Docker and similar tools. The registry hosts only metadata, so publish the package first. Each package type proves that it belongs to your registry name differently:\n\n| Package type | `registryType` | Ownership marker |\n|---|---|---|\n| npm | `npm` | `\"mcpName\": \"\"` in `package.json` |\n| PyPI | `pypi` | `mcp-name: ` in the README, which can be hidden in an HTML comment |\n| NuGet | `nuget` | `mcp-name: ` in the README |\n| Cargo | `cargo` | `mcp-name: ` as visible text, because crates.io strips HTML comments |\n| Docker/OCI | `oci` | `io.modelcontextprotocol.server.name` annotation on the image |\n\n## 4. Publish to the official MCP Registry\n\nThe registry is in preview, and its docs warn that breaking changes or data resets may happen before general availability.\n\n**Install the publisher** (a prebuilt binary, or `brew install mcp-publisher`):\n\n```bash\ncurl -L \"https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz\" | tar xz mcp-publisher\n```\n\n**Write `server.json`.** `mcp-publisher init` makes a template from your project. For a remote-only server, replace the generated `packages` array with `remotes`:\n\n```json\n{\n \"$schema\": \"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json\",\n \"name\": \"io.github.your-username/unit-converter\",\n \"title\": \"Unit Converter\",\n \"description\": \"Converts kilometres to miles. A minimal example remote MCP server.\",\n \"repository\": { \"url\": \"https://github.com/your-username/unit-converter-mcp\", \"source\": \"github\" },\n \"version\": \"1.0.0\",\n \"remotes\": [\n { \"type\": \"streamable-http\", \"url\": \"https://mcp.example.com/mcp\" }\n ]\n}\n```\n\nRules worth knowing before you publish:\n\n- `description` is limited to 100 characters.\n- A remote URL must be publicly reachable, and each URL can belong to only one server name.\n- Remotes can declare required `headers` (such as an API key marked `isSecret`) and URL template `variables` (such as `{tenant_id}`), and they can sit alongside `packages`.\n- Each publish needs a new, unique `version`. Published metadata is immutable, so you fix mistakes by publishing a new version. Semantic versions are recommended, and version ranges are rejected.\n- Custom data goes under `_meta.io.modelcontextprotocol.registry/publisher-provided`, up to 4 KB.\n\nRun `mcp-publisher validate` to check the file without publishing.\n\n**Authenticate.** The method decides which names you may use:\n\n| Method | Command | Names you can publish |\n|---|---|---|\n| GitHub OAuth | `mcp-publisher login github` (device code) | `io.github./*`, or `io.github./*` only if you are an **Owner** of the org |\n| DNS | `mcp-publisher login dns --domain example.com --private-key ...` | `com.example/*` and subdomains, with an Ed25519 or ECDSA P-384 key in a TXT record on the domain **apex** |\n| HTTP | `mcp-publisher login http --domain example.com --private-key ...` | `com.example/*`, with the public key at `https://example.com/.well-known/mcp-registry-auth` |\n| GitHub Actions | `mcp-publisher login github-oidc` (the docs' recommended CI option; the job needs `id-token: write`) | The example workflow publishes on version tags without a stored token; PAT and DNS logins also work in CI |\n\nThe registry checks that you control the namespace, not the remote URL. If the server runs on your own domain, use DNS or HTTP auth so the name and the URL visibly belong to the same publisher.\n\n**Publish and verify:**\n\n```bash\nmcp-publisher publish\ncurl \"https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.your-username/unit-converter\"\n```\n\nTo retire a version, run `mcp-publisher status --status deleted --message \"...\" `, or add `--all-versions`. Deleted entries are hidden from default listings but never removed, and setting the status back to `active` restores them.\n\n## 5. Get into the downstream directories\n\nThe registry exposes an unauthenticated read API that aggregators are expected to poll about hourly, so some directories pick your server up from there. Others need a step from you.\n\n| Directory | How a server gets in |\n|---|---|\n| [GitHub MCP Registry](https://indexagentica.com/entries/github-mcp-registry/) | Publish to the official registry first (status `active`, latest). Adding a new server to github.com/mcp is a manual curation step: GitHub's blog says to email partnerships@github.com, and requests are also posted in discussion #1257. After onboarding, new versions sync automatically. Check with `curl \"https://api.mcp.github.com/v0.1/servers?search=\"`. |\n| [Glama](https://indexagentica.com/entries/glama-mcp/) | Indexes servers from GitHub, the official registry and community submissions, then scans and scores them. To claim a repository listing, commit a `glama.json` with `maintainers` (GitHub usernames). To claim a remote connector, serve `/.well-known/glama.json` with the claim token from Glama's claim panel on your domain. |\n| [Smithery](https://indexagentica.com/entries/smithery/) | Go to smithery.ai/new and enter your public HTTPS URL, or use `smithery mcp publish \"\" -n @org/server`. It requires Streamable HTTP and OAuth if your server needs auth. If Smithery's scan can't read your tools, serve a static card at `/.well-known/mcp/server-card.json`. |\n| [Docker MCP Catalog](https://indexagentica.com/entries/docker-mcp-catalog/) | Open a pull request on `docker/mcp-registry` with `servers//server.yaml`, made with `task wizard` or `task create`, or `task remote-wizard` for remote servers. The Docker team reviews every PR. After approval, a Docker-built image is signed and published under `mcp/` on Docker Hub, and the entry appears within 24 hours. |\n| Index Agentica | Open a pull request adding `content/mcp-servers/.json`, or use the structured New entry issue. A maintainer reviews it, and `contribute.json` has the schema and rules. Agents are welcome to submit, as long as they say they are an agent and who they act for. Our own server is listed as [indexagentica-mcp](https://indexagentica.com/entries/indexagentica-mcp/). |\n\n## Checklist\n\n- [ ] Tool names and docstrings tell an agent when to use each tool.\n- [ ] `tools/list` and a real `tools/call` pass in the Inspector CLI, ideally in CI.\n- [ ] Remote: Streamable HTTP, authentication on, Host/Origin checks on (in FastMCP or your proxy), HTTPS.\n- [ ] Package: the ownership marker matches the `server.json` name exactly.\n- [ ] `server.json` passes `mcp-publisher validate`; the description fits in 100 characters; the version is new.\n- [ ] You published under a namespace you control (GitHub user or org you own, or your domain).\n- [ ] You requested GitHub onboarding, claimed the Glama listing, and submitted to Smithery, Docker and Index Agentica if they fit.\n\n## Troubleshooting (from the registry docs)\n\n| Error | Fix |\n|---|---|\n| \"Registry validation failed for package\" | The ownership marker is missing or doesn't match (`mcpName`, `mcp-name:` or the OCI annotation). |\n| \"Invalid or expired Registry JWT token\" | Log in again with `mcp-publisher login ...`. |\n| \"You do not have permission to publish this server\" | The name doesn't match your auth method, for example a GitHub login publishing outside `io.github./`. |\n| DNS auth fails with a signature error | The TXT record must be on the apex, not under a selector, and stale records from old keys must be removed. |\n\nOnce you're listed, the other side of the flow is in [Connect an agent to a remote MCP server](https://indexagentica.com/guides/connect-an-agent-to-a-remote-mcp-server/). For auth design, see [Agent auth and delegated access](https://indexagentica.com/guides/agent-auth-and-delegated-access/).\n", "html": "

A working MCP server is only half the job. Agents and their humans find servers through registries and directories, and most of those now read from one place: the official MCP Registry. This guide takes a small server from code to a published listing, then covers the directories that sit downstream.

\n

What was actually run for this guide, on 2026-10-17: the FastMCP server below (FastMCP 4.1.0), the MCP Inspector CLI calls against it over HTTP and stdio (Inspector 2.11.0), and mcp-publisher validate on the example server.json. Nothing was published to any registry.

\n
flowchart LR\n  A[Build: FastMCP] --> B[Test: MCP Inspector]\n  B --> C{Ship how?}\n  C -->|remote| D[Host over Streamable HTTP]\n  C -->|local| E[Publish package: npm / PyPI / OCI]\n  D --> F[server.json + mcp-publisher]\n  E --> F\n  F --> G[Official MCP Registry]\n  G --> H[GitHub MCP Registry, Glama, other aggregators]\n  D --> I[Smithery, Docker MCP Catalog, Index Agentica]
Mermaid diagram (source shown; not rendered client-side)
\n

1. Build a small server with FastMCP

\n

FastMCP is a Python framework for MCP servers. Install it with uv add fastmcp or pip install fastmcp (it needs Python 3.10 or later), and check with fastmcp version.

\n

A tool is a decorated function. Type hints become the input schema and the docstring becomes the description that agents read, so write it for them:

\n
# server.py\nfrom fastmcp import FastMCP\n\nmcp = FastMCP("Unit Converter")\n\n@mcp.tool\ndef km_to_miles(km: float) -> float:\n    """Convert kilometres to miles."""\n    return round(km * 0.621371, 4)\n\nif __name__ == "__main__":\n    mcp.run(transport="http", host="127.0.0.1", port=8765)
\n

Run it with python server.py. With the HTTP transport the endpoint is at /mcp, here http://127.0.0.1:8765/mcp. Calling mcp.run() with no arguments uses stdio instead, which is what local, package-based installs use. The CLI can choose at launch: fastmcp run server.py:mcp --transport http --port 8000.

\n

2. Test it with the MCP Inspector

\n

The MCP Inspector has a web UI (npx @modelcontextprotocol/inspector), a TUI (--tui) and a scriptable CLI (--cli). The CLI is the one to use from an agent or in CI:

\n
# List tools (a URL ending in /mcp means Streamable HTTP)\nnpx @modelcontextprotocol/inspector --cli http://127.0.0.1:8765/mcp --method tools/list\n\n# Call one\nnpx @modelcontextprotocol/inspector --cli http://127.0.0.1:8765/mcp \\\n  --method tools/call --tool-name km_to_miles --tool-arg km=42
\n

Against the server above, the call returned "structuredContent": {"result": 26.0976} and "isError": false. tools/list showed the km input schema and an output schema that FastMCP generated from the return type. Other useful methods are initialize (a connect-only probe), resources/list and prompts/list. For stdio, pass a command instead of a URL. For example, --cli fastmcp run server.py:mcp starts the same server over stdio, because the FastMCP CLI ignores the __main__ block. Add --header "X-API-Key: ..." for an authenticated remote.

\n

The Inspector stores OAuth tokens and stdio env: secrets in the OS keychain. On a machine without one, such as a headless Linux box or a container, they go to ~/.mcp-inspector/secrets.json, unencrypted unless you supply a key.

\n

3. Decide how it ships: remote or package

\n

The registry lists two kinds of install, and one server can offer both.

\n

Remote (hosted) server. Clients connect to a URL, and nothing is installed. Remote servers should use Streamable HTTP; SSE is deprecated and worth publishing only for existing clients. For production, FastMCP can give you an ASGI app to run under Uvicorn or similar:

\n
app = mcp.http_app()          # serve with: uvicorn server:app --host 0.0.0.0 --port 8000
\n

FastMCP's deployment guide calls authentication "highly recommended" for remote servers and notes that some clients refuse to connect without it. Bearer tokens, JWT and OAuth are covered in its auth docs, and the protocol side is in MCP authorization. The guide also documents an opt-in Host and Origin check against DNS rebinding (host_origin_protection=True with allowed_hosts). It is off by default, so turn it on or enforce the same checks in your reverse proxy. For managed hosting, the FastMCP docs point to Prefect Horizon, which they describe as free for personal projects.

\n

Package (local) server. Users run it with npx, uvx, dnx, Docker and similar tools. The registry hosts only metadata, so publish the package first. Each package type proves that it belongs to your registry name differently:

\n
Package typeregistryTypeOwnership marker
npmnpm"mcpName": "<server name>" in package.json
PyPIpypimcp-name: <server name> in the README, which can be hidden in an HTML comment
NuGetnugetmcp-name: <server name> in the README
Cargocargomcp-name: <server name> as visible text, because crates.io strips HTML comments
Docker/OCIociio.modelcontextprotocol.server.name annotation on the image
\n

4. Publish to the official MCP Registry

\n

The registry is in preview, and its docs warn that breaking changes or data resets may happen before general availability.

\n

Install the publisher (a prebuilt binary, or brew install mcp-publisher):

\n
curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
\n

Write server.json. mcp-publisher init makes a template from your project. For a remote-only server, replace the generated packages array with remotes:

\n
{\n  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",\n  "name": "io.github.your-username/unit-converter",\n  "title": "Unit Converter",\n  "description": "Converts kilometres to miles. A minimal example remote MCP server.",\n  "repository": { "url": "https://github.com/your-username/unit-converter-mcp", "source": "github" },\n  "version": "1.0.0",\n  "remotes": [\n    { "type": "streamable-http", "url": "https://mcp.example.com/mcp" }\n  ]\n}
\n

Rules worth knowing before you publish:

\n
  • description is limited to 100 characters.
  • A remote URL must be publicly reachable, and each URL can belong to only one server name.
  • Remotes can declare required headers (such as an API key marked isSecret) and URL template variables (such as {tenant_id}), and they can sit alongside packages.
  • Each publish needs a new, unique version. Published metadata is immutable, so you fix mistakes by publishing a new version. Semantic versions are recommended, and version ranges are rejected.
  • Custom data goes under _meta.io.modelcontextprotocol.registry/publisher-provided, up to 4 KB.
\n

Run mcp-publisher validate to check the file without publishing.

\n

Authenticate. The method decides which names you may use:

\n
MethodCommandNames you can publish
GitHub OAuthmcp-publisher login github (device code)io.github.<user>/*, or io.github.<org>/* only if you are an Owner of the org
DNSmcp-publisher login dns --domain example.com --private-key ...com.example/* and subdomains, with an Ed25519 or ECDSA P-384 key in a TXT record on the domain apex
HTTPmcp-publisher login http --domain example.com --private-key ...com.example/*, with the public key at https://example.com/.well-known/mcp-registry-auth
GitHub Actionsmcp-publisher login github-oidc (the docs' recommended CI option; the job needs id-token: write)The example workflow publishes on version tags without a stored token; PAT and DNS logins also work in CI
\n

The registry checks that you control the namespace, not the remote URL. If the server runs on your own domain, use DNS or HTTP auth so the name and the URL visibly belong to the same publisher.

\n

Publish and verify:

\n
mcp-publisher publish\ncurl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.your-username/unit-converter"
\n

To retire a version, run mcp-publisher status --status deleted --message "..." <name> <version>, or add --all-versions. Deleted entries are hidden from default listings but never removed, and setting the status back to active restores them.

\n

5. Get into the downstream directories

\n

The registry exposes an unauthenticated read API that aggregators are expected to poll about hourly, so some directories pick your server up from there. Others need a step from you.

\n
DirectoryHow a server gets in
GitHub MCP RegistryPublish to the official registry first (status active, latest). Adding a new server to github.com/mcp is a manual curation step: GitHub's blog says to email partnerships@github.com, and requests are also posted in discussion #1257. After onboarding, new versions sync automatically. Check with curl "https://api.mcp.github.com/v0.1/servers?search=<name>".
GlamaIndexes servers from GitHub, the official registry and community submissions, then scans and scores them. To claim a repository listing, commit a glama.json with maintainers (GitHub usernames). To claim a remote connector, serve /.well-known/glama.json with the claim token from Glama's claim panel on your domain.
SmitheryGo to smithery.ai/new and enter your public HTTPS URL, or use smithery mcp publish "<url>" -n @org/server. It requires Streamable HTTP and OAuth if your server needs auth. If Smithery's scan can't read your tools, serve a static card at /.well-known/mcp/server-card.json.
Docker MCP CatalogOpen a pull request on docker/mcp-registry with servers/<name>/server.yaml, made with task wizard or task create, or task remote-wizard for remote servers. The Docker team reviews every PR. After approval, a Docker-built image is signed and published under mcp/ on Docker Hub, and the entry appears within 24 hours.
Index AgenticaOpen a pull request adding content/mcp-servers/<id>.json, or use the structured New entry issue. A maintainer reviews it, and contribute.json has the schema and rules. Agents are welcome to submit, as long as they say they are an agent and who they act for. Our own server is listed as indexagentica-mcp.
\n

Checklist

\n
  • ☐ Tool names and docstrings tell an agent when to use each tool.
  • ☐ tools/list and a real tools/call pass in the Inspector CLI, ideally in CI.
  • ☐ Remote: Streamable HTTP, authentication on, Host/Origin checks on (in FastMCP or your proxy), HTTPS.
  • ☐ Package: the ownership marker matches the server.json name exactly.
  • ☐ server.json passes mcp-publisher validate; the description fits in 100 characters; the version is new.
  • ☐ You published under a namespace you control (GitHub user or org you own, or your domain).
  • ☐ You requested GitHub onboarding, claimed the Glama listing, and submitted to Smithery, Docker and Index Agentica if they fit.
\n

Troubleshooting (from the registry docs)

\n
ErrorFix
"Registry validation failed for package"The ownership marker is missing or doesn't match (mcpName, mcp-name: or the OCI annotation).
"Invalid or expired Registry JWT token"Log in again with mcp-publisher login ....
"You do not have permission to publish this server"The name doesn't match your auth method, for example a GitHub login publishing outside io.github.<you>/.
DNS auth fails with a signature errorThe TXT record must be on the apex, not under a selector, and stale records from old keys must be removed.
\n

Once you're listed, the other side of the flow is in Connect an agent to a remote MCP server. For auth design, see Agent auth and delegated access.

" }