Skip to main content
Glama

customclaw-mcp

npm version npm downloads License: MIT MCP

Install, don't regenerate. MCP server for the CustomClaw registry β€” 37 vetted single-file utilities for LLM and agent code (rate limiters that respect Retry-After, JSON repair, response caches, retry with backoff, token counters, PII scrubbers). Your agent gets four native tool calls instead of 120 lines of plausible-looking new code.

πŸ“– Background: The utility-amnesia problem β€” why your coding agent rewrote the same rate limiter 47 times.

30-second install

npx -y customclaw-mcp

Drop that command into your MCP client's config (snippets below) and you're done. Free tools install with no auth.

What it does

Plugs the CustomClaw catalog (37 utilities, 32 free) into any Model Context Protocol host β€” Claude Desktop, Claude Code, Cursor, Windsurf, anything that speaks MCP β€” as four tools:

Tool

Arguments

Purpose

list_utilities

β€”

Full catalog (cached 5 min)

search_utilities

query: string

Fuzzy match on slug/name/description

get_utility_info

slug: string

Full detail for one utility

install_utility

slug, target_dir, session_id?

Fetch payload + write files

Install (by client)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "customclaw": {
      "command": "npx",
      "args": ["-y", "customclaw-mcp"]
    }
  }
}

Restart Claude Desktop. Tools appear in the tool picker.

Claude Code

claude mcp add customclaw -- npx -y customclaw-mcp

Cursor / Windsurf / any stdio MCP host

Point the host at npx -y customclaw-mcp.

Streamable HTTP (smithery, ChatGPT, etc.)

Use the hosted endpoint: https://customclaw.company/mcp. Registered on smithery as onlythebestswfl/customclaw.

Example prompts

Once connected:

  • "Add a rate limiter that respects Retry-After." β†’ search_utilities β†’ install_utility rate-limit-handler

  • "I need to parse broken JSON from Claude output." β†’ json-repair

  • "What do you have for caching LLM responses?" β†’ search_utilities β†’ short results table

  • "Install token-optimiser into ./src/lib." β†’ direct install_utility

  • "Scan this project's prompts for injection β€” is there a tool?" β†’ injection-scanner

Task β†’ slug quick reference

If you need…

Slug

Rate limiting with Retry-After handling

rate-limit-handler

JSON repair for LLM output

json-repair

Response cache by prompt hash

response-cache

Retry with exponential backoff

retry-with-backoff

Token counting across models

token-optimiser

PII scrubbing before logging

pii-scrubber

Prompt-injection scanner

injection-scanner

Cost forecaster per provider

cost-forecaster

Full list via list_utilities or customclaw.company/api/catalog.

Paid utilities

For paid utilities, pass the Stripe checkout session_id from your receipt email as the session_id argument to install_utility. Without it, the tool returns a helpful 401.

Environment

  • CUSTOMCLAW_BASE β€” registry base URL override (default https://customclaw.company). Useful for staging or self-hosted mirrors.

How it works

  • Node.js stdio MCP server. Dependency: @modelcontextprotocol/sdk.

  • Catalog fetched from GET /api/catalog; cached 5 min per process.

  • Payloads from GET /api/cli?slug=<slug>[&session_id=<cs_...>] β€” same endpoint the official customclaw-cli uses.

  • install_utility refuses to write outside target_dir (path-traversal guard).

License

MIT.

Available Tools

4 tools
get_utility_infoA

Return the full catalog entry for a single utility or agent by slug (name, tagline, description, price, free flag, category, etc.).

Inputs: slug (required).

install_utilityA

Fetch a CustomClaw utility payload and write its files into target_dir. For paid utilities, pass session_id (the Stripe checkout session_id from the buyer's receipt email). Returns the list of files written and any npm dependencies the caller should install β€” this tool does NOT run npm install itself; the host agent decides when to install deps.

Inputs: slug (required), target_dir (required), session_id.

list_utilitiesA

List every utility and agent available in the CustomClaw registry (https://customclaw.company). Results are cached for 5 minutes. Returns catalog JSON with utilities and agents arrays.

Inputs: no named parameters.

search_utilitiesA

Fuzzy-search the CustomClaw registry by keyword. Matches across slug, name, tagline, description, and category. Returns the top 25 matches sorted by relevance.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a distinct purpose: getting info for a single utility, installing a utility, listing all utilities, and searching. No overlapping functionality, so an agent can easily distinguish them.

    Naming Consistency5/5

    All tool names follow a consistent οΏ½οΏ½verb_nounοΏ½οΏ½ pattern (get_utility_info, install_utility, list_utilities, search_utilities) with underscores and lowercase, making the set predictable.

    Tool Count5/5

    Four tools cover the core operations for a registry MCP (list, search, get details, install) without being excessive or insufficient, fitting the domain well.

    Completeness5/5

    The toolset provides a complete workflow from discovery (list, search, get info) to installation, with no obvious gaps for its intended use as a consumer-facing registry interface.

    Related MCP Connectors