MCP: connect Claude and Codex
Connect Levomio tools to your AI assistant.
Access and keys
Sign in to Levomio and create a key in settings. Copy it and replace YOUR_API_KEY in your chosen client’s settings. Keep the key private.
Manage keys · MCPClaude
In Claude, open Customize → Connectors → + Add → Add custom connector. Name it Levomio, enter the URL below and click Continue. Team administrators add it under Organization settings → Connectors.
https://levomio.com/api/mcpSelect No sign-in, then add a required Authorization header under Request headers. Its value must be Bearer followed by a space and your Levomio key. Save the connector and enable it in your chat’s Connectors menu.
Authorization: Bearer YOUR_API_KEYRequest headers is still limited to some Claude organizations. If the field is missing, use Claude Code below; entering only the URL will not connect this key-protected server.
Claude Code
With Claude Code installed, replace YOUR_API_KEY and run this command in your terminal. Start a new Claude Code session and run /mcp to check Levomio.
claude mcp add --transport http --scope user levomio \
https://levomio.com/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Codex
Open ~/.codex/config.toml and add the block below, replacing YOUR_API_KEY. This user-level setting is shared by Codex desktop, CLI and the IDE extension.
[mcp_servers.levomio]
url = "https://levomio.com/api/mcp"
http_headers = { Authorization = "Bearer YOUR_API_KEY" }Save the file and restart Codex. Run /mcp and check that levomio is connected. Use a current Codex version that supports HTTP MCP servers.
Try the connection
Use Levomio to show my credit balance and available tools. Do not start processing any files yet.
Credit prices
| Operation | Cost |
|---|---|
| Image compression or conversion | 1 credit per image and output format |
| Images to PDF | 1 credit per source image, merged or separate |
| PDF compression | 1 credit per source PDF page, counted by the server |
10 images into WebP and AVIF cost 20 credits. 10 images into one PDF cost 10. Compressing a 30-page PDF costs 30.
Uploads, quotes, balance checks, status checks, previews, downloads and ZIP archives are free. No subscription is required; prices and limits are the same for every account.
Credits are charged when processing starts. maxCredits is your spending limit. For batches, get the total with quote before start. Retry the same task with the same IDs and parameters to avoid paying for a new task.
50,000,000 bytes per file, 250 sources per task. Drafts and results are retained for 2 hours; check expiresAt and download in time. Website quotas do not apply to API/MCP.