ToolHive Catalog

git clone https://github.com/stacklok/toolhive-catalog
ls registries/toolhive/servers/

# List available servers in the catalog
thv registry list

# Run a specific server (example: github MCP server)
thv run github

mkdir -p registries/toolhive/servers/my-awesome-server

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.myorg/my-server",
  "description": "What your server does in one sentence",
  "title": "my-server",
  "repository": {
    "url": "https://github.com/myorg/my-server",
    "source": "github"
  },
  "version": "1.0.0",
  "packages": [
    {
      "registryType": "oci",
      "identifier": "ghcr.io/myorg/my-server:v1.0.0",
      "transport": { "type": "stdio" },
      "environmentVariables": [
        {
          "name": "API_KEY",
          "description": "Your API key",
          "isRequired": true,
          "isSecret": true
        }
      ]
    }
  ],
  "_meta": {
    "io.modelcontextprotocol.registry/publisher-provided": {
      "io.github.stacklok": {
        "ghcr.io/myorg/my-server:v1.0.0": {
          "tier": "Community",
          "status": "Active",
          "tags": ["api", "integration"],
          "tools": ["tool_name_1", "tool_name_2"]
        }
      }
    }
  }
}

git checkout -b add/my-awesome-server
git add registries/toolhive/servers/my-awesome-server/server.json
git commit -m "Add my-awesome-server MCP server"
git push origin add/my-awesome-server