> ## Agent Instructions
>
> Base URL: https://api.anysite.io
> Authentication: send the `access-token` header. Do NOT use `Authorization: Bearer`.
> Full endpoint catalog: https://app.anysite.io/docs
# Plans and credits

How credits, credit plans, MCP plans, top-ups, usage windows and the free trial work.

Goal: understand what you pay with, which plan fits how you call Anysite, and what happens when
credits or a plan run out. Prices are on the plans page, not here.

> ACTION FOR THE HUMAN: open https://app.anysite.io/billing?tab=plans (Open plans).

## Credits

- Every charged call spends credits (also called points) from your plan's balance. The cost of each
  call is returned in the `x-credits-charged` response header, and the credits left in `x-token-points`.
- A balance holds two kinds of credits:
  - **Plan credits** — set to the plan's amount at every renewal. Unused plan credits do not carry over.
  - **Purchased credits** — bought as a one-time top-up. They are not reset on renewal.
- Plan credits are spent first, then purchased credits.
- All API keys of one plan share the same balance.
- A lookup that found nothing still costs a credit on most endpoints — a "not found" (`412`) is
  charged, and so is a search that returned an empty list. A short, fixed list of database and
  enrichment endpoints answers a free `209` instead. `x-credits-charged: 0` on the response means the
  call was free. The full rule is in [Errors and limits](/docs/errors-and-limits#what-is-charged).

## Two kinds of plans

| | Credit plans (Starter, Growth, Scale, Pro, Enterprise) | MCP plans (MCP, MCP x5, MCP x15) |
|---|---|---|
| REST API | Yes | No — calls return `403` |
| MCP server | Yes | Yes |
| API keys | Copyable, managed on the Billing page | No copyable key; connect on the MCP page |
| Top-ups | Yes | No |
| Usage windows | Only if the plan sets them | 5-hour and weekly windows; higher tiers raise them |

A plan's requests-per-minute limit is shown on its card on the plans page and next to each key on the
Billing page.

## Usage windows

Plans with usage windows cap the credits spent over a rolling **5-hour** window and a rolling
**weekly** window, and some add LinkedIn-only windows of the same lengths. When a window is full,
calls return `429` until older usage leaves the window. For an MCP plan, the percentage used of each
window is shown on the MCP page.

> ACTION FOR THE HUMAN: open https://app.anysite.io/mcp (Open MCP usage).

## Top-ups

A top-up adds purchased credits to your credit plan's balance. Buying one requires an active credit
plan. Purchased credits can be spent only while the plan is active: after the plan ends, calls return
`401` `Token expired` until you renew it.

## When credits or a plan run out

| Situation | API response |
|---|---|
| Balance has fewer credits than the call's price | `401` `Points limit exhausted, required at least N points` |
| Plan period has ended | `401` `Token expired` |
| A usage window is full | `429` with `retry_after` |

A call that returns more results than its base price covers can take the balance below zero. The
negative amount is subtracted from credits you add later.

## Managing your subscription

Everything below happens on the Billing page.

> ACTION FOR THE HUMAN: open https://app.anysite.io/billing (Open billing).

- **Cancel.** Click Cancel on the active subscription. It takes effect at the end of the current
  billing period — your access and credits continue until then, and you can reactivate before the
  period ends.
- **Invoices, receipts and payment methods.** "Invoices & payment methods" on the subscription opens
  the payment portal, where they all live.
- **Promo code.** On the Plans tab, click "I have a promo code" on the plan card, enter it and apply —
  not on the payment page, which has no promo field. A code works only for a new subscription, not for
  a plan change, and it replaces the free trial: the subscription starts right away.

## Free trial

- The Starter plan and the MCP plan each offer a **7-day** free trial. The trial is not offered if you
  already had a plan of the same kind (credit or MCP), or after a card-free trial. A promo code replaces the trial: the subscription starts right away.
- **Without a card:** an account on a work email gets its trial started automatically once the email
  is verified and onboarding is finished — provided it never had a plan of that kind and has no
  credits. Onboarding decides whether this is a Starter or an MCP trial. If no payment method is added
  by the end of the trial, the subscription is cancelled.
- Upgrading during a trial ends the trial and bills the new plan immediately.