Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Bol.ai MCP API
version: 1.0.0
description: Freight-document data extraction. Upload a Bill of Lading, commercial invoice, packing list or CMR road waybill (PDF/PNG/JPG); the document type is detected automatically and returned as doc_type, with a field set tailored to that type. Fields not present in the document are null — never guessed. One document = one usage unit regardless of type. Documents and data are stored exclusively in the EU.
contact:
url: https://bol.ai
servers:
- url: https://bol.ai
security:
- apiKey: []
tags:
- name: MCP
paths:
/api/mcp:
post:
summary: MCP server endpoint
description: 'Model Context Protocol (streamable HTTP, JSON-RPC 2.0). Tools: extract_bol, extract_batch, list_documents, get_document, save_corrections, get_related_documents, export_documents, get_usage. Same Bearer authentication as the REST API. Rate limit: 60 calls / 5 min per account.'
responses:
'200':
description: JSON-RPC response
tags:
- MCP
operationId: postApiMcp
x-operation-id-source: derived
components:
securitySchemes:
apiKey:
type: http
scheme: bearer
description: 'Bol.ai API key (bolai_...). Create one in the app: https://bol.ai/app/ — available on the Professional plan or with credits; new accounts include 5 free documents.'