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

7 MCP tools at mcp.askmarcel.app: search, procedures, error codes, sourced diagnostics. JSON-RPC POST transport — no SSE streamable today.

REST API

Contractual host api.askmarcel.app/v1. Main entry point: POST /diagnostic for a one-shot sourced diagnostic.

Quotas & errors

Prepaid quotas per tier (v3). Pay-on-success on diagnostics. Single pack €29/1,000 requests beyond included envelope.

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 →