MCP Discovery Action

MCP Discovery Action

A GitHub Action to run the MCP Discovery CLI for creating, updating or printing MCP server capability details in a Markdown or other formatted file.

💡 Check out the rust-mcp-filesystem capabilities page for sample output and an example workflow: mcp-discovery.yml.

Overview

This action runs the MCP Discovery CLI to discover MCP server capabilities and create/update a file with MCP server details (create or update commands). It supports all CLI options, including built-in templates (md, md-plain, html, txt), custom Handlebars template files, or template strings.

The action downloads the latest version of the CLI binary by default, but you can specify a specific version using the action's version input.

Inputs

Input	Description	Required	Default
command	CLI command to run (create, update or print).	Yes	-
mcp-launch-command	Command and arguments to launch the MCP server (e.g., java -jar mcp.jar). Mutually exclusive with url.	No	-
url	URL of a remote streamable HTTP MCP server. Mutually exclusive with mcp-launch-command.	No	-
header	Static HTTP header(s) for the streamable HTTP transport, one Name: Value per line (repeatable).	No	-
client-id	Pre-registered OAuth client id (omit to use dynamic client registration).	No	-
client-secret	Pre-registered OAuth client secret.	No	-
scope	OAuth scope(s) to request.	No	-
redirect-uri	Redirect URI used by the authorization-code grant.	No	-
grant	OAuth grant type (client-credentials or authorization-code).	No	client-credentials
filename	Output file path for create/update commands (e.g., docs/mcp-details.md).	No	mcp-discovery.md
template	Built-in template for output (md, md-plain, html, txt).	No	-
template-file	Path to a custom Handlebars template file or folder in the repository.	No	-
template-string	Custom Handlebars template content as a string.	No	-
template-url	Remote Handlebars template URL (.hbs, .zip, or .tar.gz).	No	-
cache-dir	Cache directory for templates fetched with template-url.	No	-
log-level	Specifies the logging level for the CLI.	No	info
token	Optional GitHub token with content write permission.	No	${{ github.token }}
version	Version of the mcp-discovery CLI to use (e.g., v0.1.2). Use latest for the latest release.	No	latest

💡 For more information and command examples, refer to the MCP Discovery documentation.

Usage

Example 1: Create a Markdown File

Create mcp-discovery.md with MCP server capabilities and commit it if changed.

name: MCP Discovery (create)
on:
  push:
    branches:
      - main
permissions:
  contents: write
jobs:
  generate-md:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          token: ${{ secrets.GITHUB_TOKEN }}

      - uses: rust-mcp-stack/mcp-discovery-action@v1
        with:
          version: 'latest'
          command: 'create'
          mcp-launch-command: '[THE COMMAND YOU USE TO START YOUR MCP SERVER]'
          filename: 'mcp-discovery.md'

Example 2: Update a designated section of the README.md file

💡 For more information about update command and template markers, visit MCP Discovery documentation.

name: MCP Discovery (update)
on:
  push:
    branches:
      - main
permissions:
  contents: write
jobs:
  generate-md:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          token: ${{ secrets.GITHUB_TOKEN }}

      - uses: rust-mcp-stack/mcp-discovery-action@v1
        with:
          version: 'latest'
          command: 'update'
          mcp-launch-command: '[THE COMMAND YOU USE TO START YOUR MCP SERVER]'
          filename: 'README.md'

Example 3: Discover a remote streamable HTTP MCP server

Connect to a remote server over the Streamable HTTP transport instead of launching a local process. Use url in place of mcp-launch-command.

name: MCP Discovery (streamable HTTP)
on:
  workflow_dispatch:
permissions:
  contents: write
jobs:
  generate-md:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          token: ${{ secrets.GITHUB_TOKEN }}

      - uses: rust-mcp-stack/mcp-discovery-action@v1
        with:
          version: 'latest'
          command: 'create'
          url: 'https://mcp.example.com/mcp'
          header: |
            Authorization: Bearer ${{ secrets.MCP_TOKEN }}
          filename: 'mcp-discovery.md'

Example 4: OAuth-protected server (client credentials)

      - uses: rust-mcp-stack/mcp-discovery-action@v1
        with:
          version: 'latest'
          command: 'create'
          url: 'https://mcp.example.com/mcp'
          grant: 'client-credentials'
          client-id: ${{ secrets.MCP_CLIENT_ID }}
          client-secret: ${{ secrets.MCP_CLIENT_SECRET }}
          scope: 'mcp tools'
          filename: 'mcp-discovery.md'

Example 5: Custom template from a remote URL

      - uses: rust-mcp-stack/mcp-discovery-action@v1
        with:
          version: 'latest'
          command: 'create'
          mcp-launch-command: '[THE COMMAND YOU USE TO START YOUR MCP SERVER]'
          template-url: 'https://example.com/templates/report.hbs'
          cache-dir: '/tmp/mcp-template-cache'
          filename: 'mcp-discovery.md'

Contributing

Contributions are welcome! Please open an issue or pull request in the mcp-discovery-action repository.

License

MIT License. See LICENSE for details.