# Credits & plans

JustClaw-It charges for pulling code, not for looking. Search is free on every plan; 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 |
| `library_stats` | 0 | All plans |
| `list_licenses` | 0 | All plans |
| `get_component_bundle` | 3 | Pro |
| `compose_starter` | 10 | Pro |

Free (0 credits): connecting, `initialize`, `tools/list`, reading the MCP App view, and every discovery tool (`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 still uses its credit and counts toward the fair-use cap.

## 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:** 30 credits on day one (they don't expire), then 10 a day. The daily credits refill every 24 hours and don't carry over. No card.
- **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 but need an API key and are rate-limited per key and per network, 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.

## Usage and keys

- See balance and recent calls at [/account](/account), or run `npx @justclaw-it/cli doctor`.
- 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).