looprepo docs
looprepo grades agent loops A–F before you run them and keeps a directory of graded loops for Claude Code and Codex. These docs cover the MCP server and the Claude Code plugin.
Connect
Endpoint (Streamable HTTP): https://mcp.looprepo.dev/mcp. No sign-in and no API key.
- Claude (web and desktop): Customize → Connectors → Add custom connector, and paste the endpoint.
- Claude Code:
claude mcp add --transport http looprepo https://mcp.looprepo.dev/mcp
- Claude Code plugin (adds the server plus grading and harness commands):
/plugin marketplace add Connect-My-Email/loops-plugin /plugin install looprepo@loops
- Codex:
codex mcp add looprepo --url https://mcp.looprepo.dev/mcp
More clients (Cursor, VS Code, others) are on the MCP page.
Tools
22 tools. 20 only read. Two write, and neither deletes or changes anything that exists. No tool runs code or touches your files.
| Tool | What it does | Access |
|---|---|---|
loops_search | Search the directory by text, category, loop type, grade or source. | read-only |
loops_get | Fetch one loop: full prompt, safety notes, attribution and stats. | read-only |
loops_categories | List categories and loop types with live counts. | read-only |
loops_trending | Loops gaining copies and upvotes right now. | read-only |
loops_similar | Loops close to a given one by category, type and tags. | read-only |
loops_for_stack | Match loops to a described stack. | read-only |
loops_compare | Put loops side by side on safety, scope and cost. | read-only |
loops_stats | Directory totals by grade, category and loop type. | read-only |
loops_of_the_week | The current Loop of the Week. | read-only |
loops_grade | Grade any loop prompt A–F with the deterministic Safety Score. | read-only |
loops_grade_explain | Plain-language breakdown of why a loop got its grade. | read-only |
loops_harden | List the edits that would raise a loop’s grade. | read-only |
loops_craft | Draft a new loop from a described workflow (returned to you, not saved). | read-only |
loops_intake_recommend | Turn a read-only usage report into ranked loop picks. | read-only |
intake_prompt_get | Get the read-only intake prompt to paste into your agent. | read-only |
harness_validate | Check a harness bundle against the safe-loop checklist. | read-only |
loops_generate_harness | Generate a safe-loop harness bundle. Takes an email for the build quota; joins the newsletter only if you pass newsletter: true. | writes |
loops_submit | Contribute a loop to the review queue. Previews the redacted text first; stores only after you confirm; graded before anyone sees it. | writes |
articles_search | Search the loop-engineering guides. | read-only |
articles_get | Fetch one guide. | read-only |
cme_tier_status | Check your tier and limits. | read-only |
beacon_run_report | Recent runs for your own beacon token. | read-only |
How grading works
loops_grade runs the Safety Score: deterministic, no model, default-fail. It checks for an exit a script can verify, a turn cap, a check that runs each pass, a scope limit and a human gate before anything ships. Same code as looprepo.dev/grade. Details: the rubric.
Data and privacy
- Prompts you grade with
loops_gradeare scored in memory and not stored. (The website grader also asks a model for a plain-English explanation of the grade.) loops_grade_explain,loops_craft,loops_intake_recommendandloops_generate_harnesssend the text you give them to Anthropic to explain or draft. Intake reports are redacted first (email addresses, phone numbers, file paths, URL parameters, account numbers, keys) and are not stored. The harness email goes to our email provider (Resend) only if you ask for the newsletter.loops_submitpreviews the redacted loop text and stores it for review only after you confirm.loops_generate_harnessstores the email you give it for the build quota, and adds you to the newsletter only if you ask.- Requests are rate-limited per IP (60 a minute). Full policy: privacy and terms.
Support
Open an issue on the plugin repo or email [email protected]. Server health: https://mcp.looprepo.dev/health.