# Ocost API > Ocost reads business documents (invoices, credit notes, receipts, delivery notes, orders, quotes, contracts, statements, reminders) and finds them again by what they say. Its REST API at https://api.ocost.io/public/v1 takes a file (PDF, image or e-invoice), returns its documents as JSON (`ocost.document.v1`, in EN 16931 terms) and searches everything a business keeps in Ocost. Every request carries a business's API key: `Authorization: Bearer ocost_sk_…`. The guides are Markdown, in reading order. The OpenAPI document is the contract: every route, parameter and schema. ## MCP and OAuth Ocost is also an MCP server at https://api.ocost.io/public/mcp, with the same API keys and scopes. Apps that add servers only through OAuth connect with OAuth 2.1 and PKCE: the person signs in to Ocost and allows the access. - [Connect an assistant](https://ocost.io/docs/en/mcp.md): Connect an assistant to the MCP server (https://api.ocost.io/public/mcp, the same keys): Claude Code, Claude Desktop, Cursor, claude.ai and ChatGPT through OAuth, and any client. - [MCP tools](https://ocost.io/docs/en/tools.md): Every tool of the MCP server, by scope: what it does, its arguments and an example call. ## Guides - [Overview](https://ocost.io/docs/en/overview.md): What the Ocost API does (read business documents into structured data, search them), its address, keys, format and routes. - [Quickstart](https://ocost.io/docs/en/quickstart.md): Five steps to the first invoice as JSON: sign up, make a key, send a PDF, wait until it is read, read its document. curl, Python and JavaScript. - [Keys and scopes](https://ocost.io/docs/en/authentication.md): API keys: how a request carries one, rotating them, their scopes, and the refusals. - [Send a file and read it](https://ocost.io/docs/en/files.md): Send a file, send it again safely, wait until it is read, read its documents, get the original, delete it. - [Stay in sync](https://ocost.io/docs/en/sync.md): Collect every changed file with one call: GET /public/v1/files with updated_since, a cursor and a status filter. - [Search](https://ocost.io/docs/en/search.md): Search every document by words and by meaning: parameters, filters, results, examples. - [Connect Odoo](https://ocost.io/docs/en/odoo.md): Fill Odoo's draft vendor bills from Ocost: a small Odoo module that sends PDFs, polls, maps the document to a bill, and searches. - [The document](https://ocost.io/docs/en/document.md): The ocost.document.v1 schema in EN 16931 terms (maps to UBL and CII): an example, kind and direction, sources, checks, versions, and every field and value. - [Statuses and reasons](https://ocost.io/docs/en/statuses.md): A file's statuses and the reasons it wasn't read, and what to do for each. - [Company groups](https://ocost.io/docs/en/groups.md): Company groups: which companies a key reaches, the Ocost-Business header, routing by the document’s identifiers, needs_company, and files across the group. - [Limits and errors](https://ocost.io/docs/en/limits.md): The plan's documents a month, rate limits, sizes, RFC 9457 errors, retrying, and where the data is kept. - [Units and codes](https://ocost.io/docs/en/units.md): The document’s code lists: UNECE units with the words printed for them, ISO currencies and countries, VAT categories, payment means, document types, identifiers, ECLASS. - [Connect an assistant](https://ocost.io/docs/en/mcp.md): Connect an assistant to the MCP server (https://api.ocost.io/public/mcp, the same keys): Claude Code, Claude Desktop, Cursor, claude.ai and ChatGPT through OAuth, and any client. - [MCP tools](https://ocost.io/docs/en/tools.md): Every tool of the MCP server, by scope: what it does, its arguments and an example call. - [Germany](https://ocost.io/docs/en/germany.md): German documents: Rechnung to Lieferschein by kind, USt-IdNr. and Steuernummer, VAT categories, the § 14 UStG check, XRechnung and ZUGFeRD. - [Ukraine](https://ocost.io/docs/en/ukraine.md): Ukrainian documents: рахунок, акт and податкова накладна by kind, ЄДРПОУ, РНОКПП and ІПН with their check digits, ПДВ, dates and UAH. - [United Kingdom](https://ocost.io/docs/en/uk.md): British documents: the VAT number and company number, rates, e-invoices, dates and GBP, and what a British company’s details need. - [United States](https://ocost.io/docs/en/us.md): American documents: the EIN and state file number, sales tax read as one tax group and never checked, USD, and what an American company’s details need. - [Moldova](https://ocost.io/docs/en/moldova.md): Moldovan documents: IDNO with its check digit, IDNP and cod TVA, TVA rates, the Codul fiscal check, MDL at the National Bank of Moldova’s rates. - [Changelog](https://ocost.io/docs/en/changelog.md): What changed in the API and in what Ocost reads, newest first: new countries, identifier schemes, check items and reader versions. ## Reference - [OpenAPI document](https://ocost.io/docs/openapi.json): OpenAPI 3.1, JSON: every route, parameter, schema and error of the API ## Optional - [llms-full.txt](https://ocost.io/docs/llms-full.txt): Every English guide in one file - [Deutsch](https://ocost.io/docs/de/llms.txt) - [Français](https://ocost.io/docs/fr/llms.txt) - [Español](https://ocost.io/docs/es/llms.txt) - [Polski](https://ocost.io/docs/pl/llms.txt) - [Română](https://ocost.io/docs/ro/llms.txt) - [Українська](https://ocost.io/docs/uk/llms.txt) - [Русский](https://ocost.io/docs/ru/llms.txt)