Troubleshooting

The agent doesn't see any JustClaw-It tools

1. Restart the agent completely after changing its config (on macOS, quit Claude Desktop; closing the window is not enough).
2. Check the URL is exactly https://justclaw.it.com/mcp, including /mcp.
3. Check the header is Authorization: Bearer <key>, with one space after Bearer and no quotes inside the key.
4. Run npx @justclaw-it/cli doctor: it tests the key and every configured agent.
5. Try the curl check in Other clients.

401 / invalid_token

The key is missing, mistyped or revoked. Copy it again from the signup email, or regenerate it at /account and update your agent. A key is shown in full only once.

"Out of credits"

You've used this period's credits; the message says when they refill. Pulls resume at the next refill (every 24 hours on Free, every 7 days on paid plans), or straight away if you upgrade at /pricing. Search keeps working. Nothing is billed beyond your plan's price (plus any sales tax shown at checkout).

search_rate_limited / search_daily_cap

Search is free but limited per key and per network. search_rate_limited: wait a minute. search_daily_cap: the daily cap resets at 00:00 UTC; higher plans have higher caps (limits). Agents that loop on search burn through this fast; the search skill tells them not to repeat a search within one task.

"Daily free quota for your network reached"

Free accounts behind one network share a daily cap. Try again tomorrow or upgrade.

pull_ceiling_exceeded

You've reached your plan's yearly cap on distinct components pulled. More credits don't lift it; re-pulling components you already have still works. Email mike+mcpsupport@two7.design if you have a real need for more.

pro_required

get_component_bundle and compose_starter are Pro tools. The credit for the attempt is refunded. Pull the pieces one at a time with get_component instead, or upgrade.

"not available"

The id isn't in the public library: it may have been removed, its licence may have changed, or it was mistyped. Use ids from a fresh search_components call. The pull still uses its credit (and counts once toward the yearly fair-use cap), so copy ids exactly.

A filtered search returns few or no results

Loosen one filter at a time: drop min_composite, switch license from permissive to commercial-safe, or remove category. Describe the job, not the file name: "verify stripe webhook signature in python" works better than "webhook.py".

find_similar returns an empty list

That's expected for now on the public library; see find_similar. Search with a description of the component instead.

npx @justclaw-it/cli fails with "justclaw-it: not found"

The 0.1.0 release is rolling out on npm. Set up your client by hand from the client guides meanwhile. Also check node --version is 18.17 or newer.

Claude Desktop: the server fails to start

Claude Desktop runs npx mcp-remote, so Node.js must be installed and on the PATH that Claude Desktop sees. Check the env block holds "JUSTCLAW_IT_AUTH": "Bearer <key>" and the args list ends with "Authorization:${JUSTCLAW_IT_AUTH}" (no space after the colon). Claude Desktop guide.

The website says "Too many requests"

The site and the MCP endpoint rate-limit bursts per IP address. Slow down for a minute. If you hit it in normal use, email mike+mcpsupport@two7.design.

Still stuck?

Check /status, then email mike+mcpsupport@two7.design with the time, the tool you called and the error text. Never send your full API key; the first few characters are enough.