REST interface
The interface is described in the OpenAPI file. Every call sends the account's API key as Authorization: Bearer <key>; the key starts with apk_.
OpenAPI description (https://api.codixio.com/openapi/v1.json)
Listing and tariff work asynchronously: POST creates a job and answers 202 with the job id, GET returns status and result. The e-invoice answers synchronously.
The tariff service accepts descriptions in all languages. It assigns the confidence “high” only to descriptions in German; for other languages at most “medium”, with a review note.
curl https://api.codixio.com/v1/account -H "Authorization: Bearer apk_…"
Billing
A free quota applies first, where set. Otherwise every call reserves the current maximum price from the credit; without cover the interface answers 402. On success the actual price is charged, on failure the reservation is released.
Without sign-in
Where the operator has set a quota without sign-in for a service, it can be used a few times per IP address and day for free, through the API, the MCP server or the check on this website.
Errors
Errors of the portal are problem details (RFC 9457) with code, message and message_language, in German or English by response_language in the body or the query, else by Accept-Language. Errors of a service pass through unchanged.
MCP server
The MCP server speaks Streamable HTTP and signs in with the Codixio API account via OAuth 2.1. Besides the endpoint with all tools there is one endpoint per service:
https://api.codixio.com/mcp: all toolshttps://api.codixio.com/mcp/listing: Listing localizationhttps://api.codixio.com/mcp/tariff: Tariff classificationhttps://api.codixio.com/mcp/einvoice: E-invoice
Setup in Claude
- In Claude open Customize > Connectors and choose “Add custom connector” (on Team and Enterprise an owner sets up connectors).
- Enter the address of the MCP server, without an OAuth client id; Claude registers itself.
- Choose “Connect”, sign in with the Codixio API account and allow access.
In Claude Code:
claude mcp add --transport http codixio-api https://api.codixio.com/mcp
Then sign in with /mcp.
Setup in ChatGPT
- Turn on developer mode (according to the OpenAI help under Settings > Apps > Advanced settings; on Business, Enterprise and Edu the admin enables it).
- Add a custom MCP server, give a name and description and enter the public endpoint with the address of the MCP server as connection.
- Choose OAuth as authentication, confirm the notices, create it and sign in with the Codixio API account.
The labels in the interface depend on plan and version.