MCP · 1.1.0

Foliade MCP server documentation

The same hosted server connects Codex and Claude Code to your account. Both plugins provide instructions for transferring a local PDF securely.

Install in Codex · Install in Claude Code

Connect your account in Codex

Installing the plugin does not connect your account yet. After installation, run this command in your computer's terminal, outside the Codex conversation:

codex mcp login foliade

On the Foliade page that opens, sign in, check the account email and authorize the connection. Then return to your assistant.

If the browser does not open, open the link shown in the terminal. Do not share this sign-in link.

Wait for the terminal to confirm that login succeeded before continuing. There is no API key to copy.

Check the connection and send your first PDF · Install in Claude Code

Transport and authentication

MCP is included for free, with or without an account. Codex and Claude Code follow your plan permissions; their own access terms remain separate.

Free account: 5 published catalogues, 50 MB and 100 pages per PDF. The website and MCP share 10 upload attempts per 24 hours, including replacements and failures, with only one upload in progress. Views remain unlimited.

Without an account, on the website or through MCP: 3 PDFs per IP per 24 hours, 50 MB and 100 pages per PDF, one upload in progress. Publication lasts 30 days; private management lasts 30 minutes. Keep the private link to attach the catalogue to an account before it expires.

Free tier protection: processing is limited to 120 seconds, 512 MB per result and 2 GB of storage per account. Overall capacity is limited; paid plans have priority. If a request is refused, wait for the stated delay without automatic retries.

Before each transfer, the assistant checks the account or guest mode and explains the limits returned by Foliade. The draft remains private until you request publication.

https://foliade.gekkode.com/mcp

OAuth sign-in is optional for a guest upload and required to access your account, including a free account. The server checks permissions for every action; an expired connection never becomes guest access.

Access tokens last one hour. Refresh tokens rotate on each use without extending the connection beyond 30 days. Reusing a refresh token revokes the entire connection.

Customers can use dynamic registration or customer identity documents OpenAI and Anthropic. Metadata is public:

/.well-known/oauth-authorization-server
/.well-known/oauth-protected-resource/mcp

The permissions are separated:

foliade:read — read the account, catalogs and statistics;
foliade:write — transfer a PDF and create a draft;
foliade:publish — publish or unpublish a catalog.

The eight tools

Tool	Settings	Result
`foliade_account`	—	Account email, plan and maximum PDF size.
`foliade_list_catalogues`	`limit=25 (1–100), offset=0`	Account catalogues and pagination cursor.
`foliade_prepare_upload`	`filename, size_bytes, sha256, notice_version, guest_mode=false, title="", language="fr"`	Upload ID, HTTPS URL and temporary header for transferring the PDF.
`foliade_finalize_upload`	`upload_id, guest_token=""`	Private draft and conversion status. Retrying returns the same catalogue.
`foliade_catalogue_status`	`catalogue_id, guest_token=""`	Catalog status, pages and conversion progress.
`foliade_publish_catalogue`	`catalogue_id, guest_token=""`	Publication of the existing catalog, without reconversion.
`foliade_catalogue_stats`	`catalogue_id, days=30 (1–3650)`	Aggregated statistics, without contact details.
`foliade_unpublish_catalogue`	`catalogue_id, guest_token=""`	Closing the public link, without deleting the data.

Transferring a local PDF

The remote server cannot read files from a path on your computer. The plugin computes the selected file's size and SHA-256 digest, prepares an upload, transfers its bytes over HTTPS, then finalizes the draft.

The ticket expires after 10 minutes and only allows transfer of the declared PDF, within 120 seconds. The free tier allows one upload in progress; paid accounts can open five transfers.

The conversion is asynchronous. The assistant checks its result before announcing success. Public publication requires a separate action; the draft remains private by default.

The PDF must be readable, password-free, and within the limit displayed by the account verification tool.

Errors and revocation

401: connection missing, expired or revoked. Reconnect the account.
403: insufficient permission. Check the offer and authorized rights.
413: file too large. Reduce the PDF.
422: the received file differs from the declared file. Start a new upload.
429: too many requests. Respect the retry timeout.

Tool errors are reported in their MCP result. A catalog from another account remains inaccessible. A corrupted PDF or failed conversion should never be presented as successful.

In Foliade → API → Connected assistants, you can revoke each connection. Access ends immediately without deleting your catalogues.

Sources and distribution

Public connector repository · README · Skill Foliade

Plugin ZIP · Skill ZIP · SHA-256

This public marketplace is maintained by Foliade. It is not a listing in the official OpenAI or Anthropic directories, which require a separate review.

Compatibility with the old installation

The local Python script remains available as an advanced solution with an API key and its five historical tools. It is no longer launched by plugins 1.1.0. Its keys and settings are independent of the OAuth connection.

Historical STDIO script · API documentation REST