# 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](/docs/clients/other#check-it-with-curl).

## 401 / invalid_token

The key is missing, mistyped or revoked. Copy it again from the signup email, or regenerate it at [/account](/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](/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](/docs/credits#search-limits)). Agents that loop on search burn through this fast; the [search skill](/docs/skills) 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](/docs/tools#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](/docs/quickstart#2-connect-your-agent) 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](/docs/clients/claude-desktop).

## 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](/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.