FounderMCPDocs

Credits & costs

Credits & costs

What each action spends, from the live credit table. Previews are free.

View Markdown

One balance covers the app, MCP and REST. You pay for a row that is returned. A miss is free. The numbers below are the live credit table. GET /usage returns balance and today.credits_remaining. A paid response repeats the charge in X-Credits-Used and X-Credits-Charged, and sends X-Credits-Remaining when the wallet can be read.

Per action

  • Company with a buying signal — 1 credit (funding_company, and a company row on an event).
  • Company using a technology — 20 credits (tech_company).
  • Event lookup — 0 credits (event).
  • Person, before a buyer profile — 5 credits. That covers engagement, a new role, a mention, an event person (raw rows: no AI judged them), and POST /leads (leads_person).
  • Person from Search People — 1 credit per person, charged per page of 25 (person_search_row): a page with results is 25 credits, however many people it holds. An empty page is free.
  • Qualified lead — 20 credits (screened_exact_lead). Exact fit on a screened search.
  • Just outside — 5 credits (screened_close_match).
  • Full profile — 2 credits (enrich_profile), only when a profile is returned.
  • Work email — 10 credits on top of the profile when an address is found. Together that is 12 (enrich_email).
  • Company enrich — 1 credit (company_enrich).
  • Email and phone — 40 credits, in the app, only when the phone is found. POST /person/enrich has include_email and no phone field.

lookup_company, explain_lead, get_search_results, list_mentions, and every /preview route are free. Creating a monitor is free. A monitor run charges the mention price above.

preview_cost and max_credits

preview_cost takes endpoint searches, leads, person.enrich or monitors, and the body you would have sent. It returns credits_per_row, max_rows, max_credits and period (call or day). Nothing is fetched.

The same max_credits field on the real call stops before the next row would pass it (truncated_by max_credits). Below the cost of one row the call is 402 max_credits_exceeded and nothing runs. On people search and people enrich, max_credits is accepted only when the Signals API is open.

Usage for the key is Get Usage, which is free.