Documentation

Getting started

Connect the GitHub App

Sign in to the Repospec dashboard and install the GitHub App for the organizations or accounts that host your spec repositories. The app requests only the repository access you grant.

Register a project and spec paths

Create a project in Repospec by selecting a GitHub repository and branch, then register one or more spec file paths (and a project slug). These paths define which files the project can fetch for MCP tools.

Create an MCP token

In the dashboard, create an MCP token. You will use this token in the Authorization header when connecting MCP clients to the Repospec MCP server (Authorization: Bearer <token>).

IDE configuration (example)

Configure your MCP client to point at the Repospec MCP endpoint and include your token. The exact file and format depend on your client; follow your product’s MCP configuration docs and set the server URL and bearer token Repospec provides.

MCP tools

Repospec exposes the following MCP tools. Tool names and parameters match the server implementation.

`list_spec_files`

Returns all registered projects and their spec file paths.

Arguments: none.

`read_spec`

Retrieves spec file contents for a given project.

Arguments:

project (required): Project slug to retrieve. Use list_spec_files to see available slugs.
path (optional): Specific spec file path. Omit to fetch all registered spec files for the project.

`search_specs`

Searches spec file contents by keyword across projects (backed by cached content where applicable).

Arguments:

query (required): Search keyword. Must not be empty.
project (optional): Limit the search to a single project. Omit to search all projects.

Plans and limits

Free plan

Limit	Value
Total spec file paths across all projects	20
MCP tokens you can have at the same time	1

Project registration limits may apply separately; the table above reflects the spec path and MCP token caps enforced for the Free plan.

Personal plan

Limit	Value
Total spec file paths across all projects	200
MCP tokens you can have at the same time	5

Pricing is USD $8 / month.

FAQ

What counts toward the spec file path total?

The sum of registered spec file paths across all projects cannot exceed 20 on Free or 200 on Personal.

How many MCP tokens can I have?

Free allows 1 active MCP token at a time. Personal allows up to 5. On Free, create a new token after revoking the existing one if you need to rotate credentials.