Generic GitHub Action to publish your MCP server to the MCP Registry. The action constructs server.json behind the scenes using the official schema and publishes it via the MCP Publisher CLI with GitHub OIDC.

Schema reference: docs/reference/server-json/server.schema.json in the MCP Registry repository.

Trigger on tags and grant id-token: write. The action accepts only the schema-required fields and transport/package essentials.

name: Publish MCP Server

on:
  push:
    tags:
      - 'v*'

jobs:
  publish:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      id-token: write

    steps:
      - uses: actions/checkout@v4

      - name: Publish to MCP Registry (PyPI, stdio)
        uses: OtherVibes/mcp-publish-action@v1
        with:
          name: io.github.owner/repo
          description: "MCP server providing weather data and forecasts"
          version: "1.0.0"
          registry_type: pypi
          identifier: my-server
          transport_type: stdio
          # Optional: website_url: https://example.com
          # Optional: registry_base_url: https://pypi.org

Notes

• Version handling: Use semantic versioning (e.g., "1.0.0", "2.1.0-alpha"). For tag-based releases, you can use ${{ github.ref_name }} but ensure your tags are proper versions (not branch names).
• Repository metadata: Auto-populated using the current GitHub repo URL and source: github.
• For remote transports, use:
  • transport_type: streamable-http and provide transport_url
  • transport_type: sse and provide transport_url
• Authentication: uses GitHub Actions OIDC tokens (github-oidc method) which works automatically with the id-token: write permission

• Ubuntu runner with curl and tar; jq will be installed if missing
• Workflow permission id-token: write for GitHub OIDC