Skip to content
Spectral

Community Tools

The community catalog lets you share and discover MCP tool collections. Browse the catalog at getspectral.sh/catalog or use the CLI.

Authentication

Section titled “Authentication”

Catalog operations require a GitHub account. Log in once with the GitHub Device Flow:

Terminal window
spectral community login

This opens your browser for authorization and stores a token locally. Check your login status by running the command again — it will show your username if already authenticated.

To remove your stored token:

Terminal window
spectral community logout

Searching

Section titled “Searching”

Find tool collections by keyword:

Terminal window
spectral community search <query>

Results show each collection’s name, description, tool count, success rate, and usage stats. Collections you have already installed are marked.

You can also browse and search the catalog from the web at getspectral.sh/catalog.

Installing

Section titled “Installing”

Install a collection by its <user>/<app> reference:

Terminal window
spectral community install romain/planity-com

This downloads the tool definitions from the spectral-tools repository and stores them locally. Installed tools are immediately available via the MCP server (spectral mcp stdio).

Catalog-installed apps are stored with a <user>__<app> naming convention to avoid conflicts with your own analyzed apps.

Publishing

Section titled “Publishing”

Share your own tools with the community:

Terminal window
spectral community publish <app_name>

This requires:

  1. An app with at least one generated tool (see MCP tools)
  2. Being logged in via spectral community login

The command creates a pull request on the spectral-tools repository with your tool definitions. Your contribution will be reviewed before being merged into the catalog.

You can republish at any time to update your tools — the existing pull request will be updated.

Usage stats

Section titled “Usage stats”

When you search the catalog, Spectral automatically reports anonymous usage statistics for your installed catalog tools (call counts, success/error rates). This helps the community see which tools are actively used and reliable.