Skip to content
Agentic Scraper

Charge API quickstart

The provider service receives these headers from the MCP Market proxy for a provider_event entry:

x-agentic-charge-token
x-agentic-charge-run-id
x-agentic-charge-mcp-id
x-agentic-charge-selection-id
x-agentic-charge-max-total-usd

Use the run ID in the charge URL and send the signed token back unchanged:

Terminal window
curl --request POST \
  --url "https://api.agenticscraper.com/api/v1/provider/runs/$RUN_ID/charge" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $AGENTIC_SCRAPER_API_KEY" \
  --header "x-agentic-charge-token: $CHARGE_TOKEN" \
  --header "idempotency-key: $OPERATION_ID" \
  --data '{
    "eventName": "profile-lookup",
    "count": 1
  }'

The event must exist as an active row for the MCP entry. The URL runId, token runId, token provider user, and authenticated account must match.

The canonical external base URL is https://api.agenticscraper.com/api/v1. Node.js and Python provider SDKs use this value by default.

Provider charging is part of the same public REST API and OpenAPI document. Only the server-side provider SDK package is separate from consumer client SDK packages.