API & MCP documentation

Guides, reference and platform tutorials to integrate AskMarcel into your product or AI agent — no account required to read, Developer account to act.

Get started in 3 steps

Three steps: get an ak_live_ key, send a diagnostic request, read the sourced JSON response. Contractual host: api.askmarcel.app/v1.

View quickstart →

Guides

Authentication

Two modes: Bearer API key (ak_live_ for server/MCP, pk_live_ for client) or OAuth 2.0 (Claude connectors). Never use the legacy sk_* prefix.

MCP Server

15 MCP tools at mcp.askmarcel.app: lookup, guided PAC, SKU provenance and Harness Beta session loop (Air/Water + Air/Air). JSON-RPC POST — no SSE.

REST API

Contractual host api.askmarcel.app. v1 = sourced lookup. v2 = strict SKU provenance (diagnostic null if no exact manual).

Quotas & errors

Strict monthly quotas per tier (v4). Harness creation consumes session quota only. No packs or postpaid billing.

Webhooks

Webhooks are configured in the authenticated developer area (Starter+). Signed JSON payload, automatic retry.

Platform integrations

OpenAPI reference

Full API surface at api.askmarcel.app/v1/openapi.json — rendered by Scalar.

Open reference →