JustClaw-It

npx add-mcp 'https://justclaw.it.com/mcp'

JustClaw-It is a remote MCP server for coding agents. Your agent searches 1,459,472 licence-cleared components mined from real open-source repositories, then pulls the one it wants: full source, a GitHub permalink, the SPDX licence, the copyright holder and an attribution header to keep with the code.

• Search is free. find_similar, library_stats, list_categories, list_licenses, search_components cost 0 credits (an API key is still required, and searches are rate-limited).
• A pull costs 1 credit. get_component returns the source. The Pro tools cost more (3 and 10 credits).
• Plans: Free ($0: 30 credits on day one, then 10 a day), Solo $10/month, Indie $19/month, Pro $49/month. Every plan is a hard cap: nothing is ever billed beyond the plan price (plus any sales tax shown at checkout).
• Licence and attribution travel with every component, and the public library only serves permissive and weak-copyleft code.

New here? Start with the Quickstart.

Quickstart

1. Get a free API key (email only, no card).
2. Run the installer on the machine your agent runs on:

npx @justclaw-it/cli init

or, without npm on your PATH:

curl -fsSL https://justclaw.it.com/install | sh

The CLI checks your key with a live tools/list call, finds the agents on your machine and adds the justclaw-it server to each, backing up every file it edits first. Restart your agent and ask: "search JustClaw-It for a stripe checkout handler". Details: CLI. Prefer to edit config by hand? See the client setup below.

Client setup (manual)

Server URL https://justclaw.it.com/mcp (Streamable HTTP), header Authorization: Bearer <YOUR_API_KEY>. Replace <YOUR_API_KEY> with your key. Each client also has its own page with verification steps: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, OpenClaw, Hermes Agent, other clients.

Claude Code

One command:

claude mcp add --transport http --scope user justclaw-it https://justclaw.it.com/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "justclaw-it": {
      "url": "https://justclaw.it.com/mcp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.justclaw-it]
url = "https://justclaw.it.com/mcp"
http_headers = { "Authorization" = "Bearer <YOUR_API_KEY>" }

OpenClaw

Register the server, then reload a running gateway:

openclaw mcp set justclaw-it '{"url":"https://justclaw.it.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer <YOUR_API_KEY>"}}'
openclaw mcp reload

Hermes Agent

Add to ~/.hermes/config.yaml, and put JUSTCLAW_IT_API_KEY=<YOUR_API_KEY> in ~/.hermes/.env:

mcp_servers:
  justclaw-it:
    url: "https://justclaw.it.com/mcp"
    headers:
      Authorization: "Bearer ${JUSTCLAW_IT_API_KEY}"

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "justclaw-it": {
      "serverUrl": "https://justclaw.it.com/mcp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json (macOS ~/Library/Application Support/Claude/, Windows %APPDATA%\Claude\, Linux ~/.config/Claude/). Claude Desktop reaches remote servers through the mcp-remote bridge, so it needs Node.js:

{
  "mcpServers": {
    "justclaw-it": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://justclaw.it.com/mcp", "--header", "Authorization:${JUSTCLAW_IT_AUTH}"],
      "env": { "JUSTCLAW_IT_AUTH": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Any other MCP client

Streamable HTTP with a standard bearer header:

{ "mcpServers": { "justclaw-it": { "url": "https://justclaw.it.com/mcp", "headers": { "Authorization": "Bearer <YOUR_API_KEY>" } } } }

VS Code

Add to .vscode/mcp.json (or your user mcp.json); VS Code asks for the key once and stores it:

{
  "inputs": [
    { "type": "promptString", "id": "justclaw-it-key",
      "description": "JustClaw-It API key", "password": true }
  ],
  "servers": {
    "justclaw-it": {
      "type": "http",
      "url": "https://justclaw.it.com/mcp",
      "headers": { "Authorization": "Bearer ${input:justclaw-it-key}" }
    }
  }
}

Tools

The table is generated from the server's own tools/list, so it matches what your agent sees. Full parameters, examples and result fields: Tool reference.

tool	parameters	credits	plan
search_components	query, limit (optional), category (optional), min_composite (optional), language (optional), license (optional), offset (optional), max_per_repo (optional)	0	All plans
find_similar	id, limit (optional)	0	All plans
list_categories	limit (optional)	0	All plans
get_component	id	1	All plans
library_stats	none	0	All plans
list_licenses	none	0	All plans
get_component_bundle	component_id	3	Pro
compose_starter	prompt, stack (optional)	10	Pro

Each result carries five sub-scores (completeness, code quality, deployability, reusability, strategic value) and a composite score from 0 to 10; filter with min_composite. See Scores & ranking.

Credits & plans

Searching is free. One credit is one component pull (get_component). Free gets 30 credits on day one, then 10 a day that do not carry over. Paid plans refill weekly, keep what you don't spend, and earn up to 1.5x credits the longer you stay. Pro adds component bundles and starter projects. When credits run out, pulls stop until the next refill, renewal or an upgrade; you are never billed per credit. Live prices and checkout: /pricing. More: Credits & plans.

plan	price	credits	fair-use cap	API keys	extras
Free	$0	10 per day, plus 30 on day one; resets daily, no carry-over	none	1	none
Solo	$10/month	300 per week; unused credits carry over	6,000 distinct components a year	1	none
Indie	$19/month	1,000 per week; unused credits carry over	15,000 distinct components a year	1	none
Pro	$49/month	5,000 per week; unused credits carry over	100,000 distinct components a year	3	component bundles, starter projects

Search limits

Search and the other discovery tools (find_similar, library_stats, list_categories, list_licenses, search_components) cost no credits but need an API key and are rate-limited so free search can't be abused. A call over a limit gets a readable error instead of results; nothing is charged.

plan	searches per minute, per key	searches per day, per key
Free	20	300
Solo	30	2,000
Indie	30	4,000
Pro	60	10,000

Per network (client IP, IPv6 /64): 60 searches a minute across all keys, and 1,000 a day across new free accounts. Days reset at 00:00 UTC.

Licences & attribution

• Every component is third-party open-source code, served under its original licence. JustClaw-It sells access to the search and retrieval service (credits), not the code.
• The public library only includes permissive and weak-copyleft licences. Strong copyleft (GPL, AGPL) and code without a clear licence are excluded.
• Each result carries its SPDX licence, copyright holder and repository, and returned source starts with an attribution header. Keep that header, and include the licence text where the licence requires it (a THIRD_PARTY_LICENSES or NOTICE file works).
• The full list of source repositories, licences and copyright holders: list_licenses, or /licenses.

More: Licences & attribution.

FAQ

How is this different from Context7?

Context7 tells your agent how a library works; JustClaw-It hands it production code that uses it. They complement each other: docs for the API, JustClaw-It for a working, attributed implementation. A longer comparison is on the blog.

What does a search cost?

Nothing. A pull is 1 credit; get_component_bundle is 3 and compose_starter is 10. Connecting, listing tools and handshakes are free.

What happens when I run out of credits?

Pulls stop until your next refill (tomorrow on Free, next week on paid plans) or until you upgrade. Search keeps working within its limits. More answers: FAQ and Troubleshooting.

All pages

• Start: Quickstart
• Reference: Tools, Credits & plans, Licences & attribution, Scores & ranking, Security advisories, MCP App view
• Tooling: CLI, Agent skills
• Help: FAQ, Troubleshooting, Changelog
• For LLMs: /llms.txt (index) and /llms-full.txt (every page in one file). Every page is also available as Markdown: add .md to its URL.