Skip to content

Run context headers

For provider_event, the proxy emits:

Header Value source
x-agentic-charge-token HMAC-SHA256 signed context token.
x-agentic-charge-run-id JSON-RPC call ID generated by the proxy.
x-agentic-charge-mcp-id Marketplace entry UUID.
x-agentic-charge-selection-id Agent MCP selection UUID.
x-agentic-charge-max-total-usd MCP_PROVIDER_DEFAULT_MAX_CHARGE_USD.

The signed token payload contains runId, buyer user ID/email, provider user ID, MCP ID, selection ID, optional tool name, max total charge, and expiry.

The backend rejects malformed signatures, expired tokens, mismatched URL run IDs, and provider-account mismatches.

The current default token lifetime is controlled by MCP_PROVIDER_CONTEXT_TTL_SECONDS and defaults to 3600 seconds. The default run charge cap is controlled by MCP_PROVIDER_DEFAULT_MAX_CHARGE_USD and defaults to 50 USD. Deployments can override both values.