# Credits & plans

JustClaw-It charges for pulling code, not for looking. Search is free on every plan, and keyless search works with no key at all (with per-network caps, below); credits pay for pulls.

## What costs credits

| tool | credits per call | plan |
| --- | --- | --- |
| `search_components` | 0 | All plans |
| `find_similar` | 0 | All plans |
| `list_categories` | 0 | All plans |
| `get_component` | 1 | All plans |
| `check_component_security` | 0 | All plans |
| `library_stats` | 0 | All plans |
| `list_licenses` | 0 | All plans |
| `get_component_bundle` | 3 | Pro |
| `compose_starter` | 10 | Pro |
| `licence_report` | 0 | All plans |

Free (0 credits): connecting, `initialize`, `tools/list`, reading the MCP App view, and every discovery tool (`check_component_security`, `find_similar`, `library_stats`, `list_categories`, `list_licenses`, `search_components`). One credit is one `get_component` pull. Calls refused before they run (bad key, no credits, rate limit) are not charged. A Pro tool tried on a non-Pro key, a Pro tool that produces nothing, and a pull refused by the fair-use cap are refunded. A pull of an id that isn't in the public library is refunded and doesn't count toward the fair-use cap. After 20 such misses in a minute, or 300 in a UTC day, an account's `get_component` calls are refused (and refunded) until that minute or day ends.

## 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 |

- **Free:** up to 300 free component pulls a month (10 a day) plus 30 on signup (those don't expire). The daily credits refill every 24 hours and don't carry over. No card. Free search on every plan.

A JustClaw-It pull returns a complete, licence-cleared component (full source, its licence, attribution header and GitHub permalink), not a snippet of documentation.
- **Solo** ($10/month), **Indie** ($19/month) and **Pro** ($49/month) refill every 7 days (300, 1,000 and 5,000 credits) and keep what you don't spend while you stay subscribed.
- **Pro** adds `get_component_bundle` (3 credits) and `compose_starter` (10 credits), and up to 3 API keys on one account.

Live prices and checkout: [/pricing](/pricing). Payments are handled by Stripe. Prices are in US dollars and exclude sales tax; where tax applies (currently Texas), Stripe adds it at checkout and shows it before you pay.

## No overage, ever

Every plan is a hard cap. When your credits run out, pulls stop until the next refill or renewal, or until you upgrade. JustClaw-It never bills per credit and never charges more than your plan's price (plus any sales tax shown at checkout). Search keeps working within its limits while you are out of credits.

## Fair-use cap

Paid plans have a yearly cap on **distinct** components pulled (6,000 on Solo, 15,000 on Indie, 100,000 on Pro), to stop bulk copying of the library. Re-pulling something you already pulled doesn't count again. The cap is separate from credits: more credits don't lift it. Hitting it returns `pull_ceiling_exceeded`.

## Loyalty

Paid plans earn more credits the longer you stay subscribed, up to 1.5x the weekly refill.

| months subscribed | weekly credit multiplier |
| --- | --- |
| 0+ | 1.00x |
| 3+ | 1.10x |
| 6+ | 1.20x |
| 12+ | 1.35x |
| 24+ | 1.50x |

## Search limits

Discovery tools cost no credits and are rate-limited per key and per network (keyless search has its own, lower limits, below), so free search can't be abused. Over a limit you get a readable error (`search_rate_limited` or `search_daily_cap`) and 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. A search page holds up to 50 results.

### Without a key

`search_components` also answers keyless requests to `https://justclaw.it.com/mcp`, so you can try it before you sign up: 5 searches a minute and 50 a day per network (client IP, IPv6 /64), up to 5 results a page. Every other tool returns a "get a free key" message instead. A free key lifts search to the limits above.

## Usage and keys

- See balance and recent calls at [/account](/account), or `curl -H "Authorization: Bearer $JUSTCLAW_IT_API_KEY" https://justclaw.it.com/usage`.
- With a key: `curl -H "Authorization: Bearer $JUSTCLAW_IT_API_KEY" https://justclaw.it.com/usage`.
- Regenerate a leaked key at [/account](/account). One free account per person.

## Cancelling and refunds

Cancel any time yourself with **Manage billing / Cancel** on your [account page](/account#billing) (the same screen updates your card and lists invoices), or by email. You keep your plan until the end of the period you paid for. Used credits are not refundable. A first purchase can be refunded within 7 days if no credits were used. Full rules: [refund policy](/refund).