Use Spekkr specs in Claude Code

Connect Claude Code to Spekkr's MCP server, then search, pull and build a spec. One command. No API key.

2 minutes to read

Add the server

Claude Code adds a remote HTTP server with one command. HTTP is the transport it uses for a Streamable HTTP server. In a JSON file, streamable-http is another name for http.

claude mcp add --transport http spekkr https://spekkr.com/mcp

Run that in the project you are working in. With no --scope, Claude Code saves it for you, for that project only, in ~/.claude.json. It does not ask for a key.

To use Spekkr in every project on this machine, add --scope user. That is the same file. To commit the server with a repository, add --scope project. Claude Code writes .mcp.json at the project root:

claude mcp add --transport http spekkr --scope user https://spekkr.com/mcp

claude mcp add --transport http spekkr --scope project https://spekkr.com/mcp

{
  "mcpServers": {
    "spekkr": {
      "type": "http",
      "url": "https://spekkr.com/mcp"
    }
  }
}

A url with no type is read as a local command, so Claude Code skips it. In an interactive session, Claude Code asks you to approve a project file before it uses those servers.

Checked 20 November 2026. Claude Code's MCP docs.

Without connecting

An agent that can open a web address does not need the server. Paste one line. The address is that spec's start note.

Build the spec at https://spekkr.com/juno/waitlist/start.md.

juno/waitlist is a waitlist spec. The note tells the agent to fetch the files, record the choices and build.

Search, then pull

With the server connected, paste this:

Search Spekkr for a waitlist spec, then pull juno/waitlist with database=sqlite.

Spekkr tells the agent to search with search_specs, read get_spec, then call pull_spec with the person's choices. Write the files into a folder and follow BUILD.md.

juno/waitlist lists database as postgres or sqlite. The default is postgres, so the prompt sets sqlite. A choice the spec does not offer is refused. Anything left out keeps the spec's default.

Search, get and pull need no sign-in. Publishing, unpublishing and whoami do: the agent opens a Spekkr page, and Spekkr emails a code. There is no password. Questions: support@spekkr.com.

The other tools, and the limits, are on the docs page. Every agent is listed on the setup index.