MCP billing

Sleepwalker uses the same credit system for MCP, API, and Console actions.

Read tools do not consume credits. Billable action tools return billing metadata.

Credit Prices

MCP action	Credits
serialize_sleepwalker_page_content	1
suggest_sleepwalker_visibility_prompts	1
discover_sleepwalker_content_trends	1
score_sleepwalker_content with supplied trends	2
score_sleepwalker_content without supplied trends	3
create_sleepwalker_visibility_run	each queued probe’s model price (platform defaults range from 1 to 6 credits)
create_sleepwalker_content_run with analysis_depth: score	3
create_sleepwalker_content_run with analysis_depth: full	6

Every visibility probe costs its model’s own per-probe price; platform defaults range from 1 to 6 credits. Call list_sleepwalker_visibility_models for each model’s credits_per_probe.

Public pricing:

1 credit = €0.02
minimum top-up = €5.00

Billing Metadata

Billable tools include a billing block or equivalent credit fields.

Example:

{
  "billing": {
    "billable": true,
    "credit_action": "pages.content.serialize",
    "estimated_credits": "1.00",
    "credits_enforced": true,
    "status": "settled",
    "reserved_credits": "1.00",
    "settled_credits": "1.00",
    "released_credits": "0.00"
  }
}

Lifecycle

State	Meaning
estimated	Sleepwalker reports expected credit usage.
reserved	Credits were held before work started.
settled	Credits were charged after successful work.
released	Reserved credits were returned because work did not complete as billable.

See Credit Lifecycle for the shared lifecycle.

Failures

Credits are not settled for work that is rejected before execution.

For AI Visibility, probes settle only when Sleepwalker returns a usable response or citations. Probes that fail without a usable result release their reserved credits.

If work starts and then cannot complete, the response and Activity entry indicate whether credits were settled or released.

Partial AI Visibility Runs

If a visibility run asks for more probes than the account can fund, Sleepwalker can queue the funded probes and mark the rest as skipped.

The funded probes remain accessible. Skipped probes are visible as not run because of insufficient credits.

Top-Ups

Use Add Credits in the Sleepwalker app to top up the account balance.