Contribute a cartridge

A cartridge teaches learnmcp about one tool — plain JSON, no executable code. The registry is a directory in the repo, so contributing is a pull request. Once it merges, every learnmcp picks it up on its next refresh; nothing is redeployed.

1. Write it

Paste your JSON below to check it against the schema before you open a PR. This validates in your browser — nothing is uploaded.

2. Open a pull request

Add it at cartridges/<id>/<id>.json and open a PR against the repo. CI validates every cartridge on the branch.

$ git clone https://github.com/quintonwall/learnmcp.git
$ mkdir -p cartridges/my-tool
$ $EDITOR cartridges/my-tool/my-tool.json
$ npm install && npm test
$ git checkout -b add-my-tool && git commit -am "Add my-tool cartridge" && git push

Create the file on GitHub →Full guide →

Two things reviewers look for. Matchers should target what the tool actually emits — a plugin’s slash commands and its MCP tools are different names for the same action, so accept both with anyOf. And prefer several narrow matchers to one loose regex: a badge that’s easy to earn by accident isn’t worth earning.

Don’t want to write it by hand?

Ask learnmcp to draft one from a docs page, then review and PR it:

You: generate a cartridge from https://example.com/docs