Foliade

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Turn PDFs into mobile flipbook catalogues: upload private drafts, customise, publish, get stats.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Foliade": {
      "url": "https://foliade.gekkode.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (35)

• foliade_account read-only

  Confirms the address and the plan of the destination account, without secrets or payment data.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• foliade_list_catalogues read-only

  Lists the private and public catalogues of the connected account, with pagination.

  Parameters:

  • limit — integer
  • offset — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• foliade_prepare_upload

  Creates a single-use 10-minute deposit. Compute the size and the SHA-256 of the local PDF. Transfer the bytes to upload_url with PUT, Content-Type application/pdf, with the headers returned. Do not publish these headers in your reply. This ticket allows no reading and is not an API key for the account.

  Parameters:

  • filename (required) — string
  • size_bytes (required) — integer
  • sha256 (required) — string
  • title — string
  • language — string
  • guest_mode — boolean
  • notice_version — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• foliade_import_url

  Fetches a PDF that is already online and prepares it as a private draft. Use this when the user gives a link, or when your host hands you an attachment as a download URL rather than a local file. For a file on the user's machine, use foliade_prepare_upload instead. Only public https links are accepted, and the server checks that the link really returns a PDF. Call foliade_finalize_upload next with the upload_id.

  Parameters:

  • url (required) — string
  • title — string
  • language — string
  • guest_mode — boolean
  • notice_version — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• foliade_finalize_upload

  Finalises an upload that has been received. A repeat returns the same catalogue, never a duplicate. Conversion is asynchronous: check foliade_catalogue_status before giving the final result. The catalogue stays private until it is published explicitly.

  Parameters:

  • upload_id (required) — string
  • guest_token — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• foliade_catalogue_status read-only

  Private state: owner OAuth or guest token, never the public link alone.

  Parameters:

  • catalogue_id (required) — string
  • guest_token — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• foliade_publish_catalogue

  Makes the catalogue public, on explicit request only. Keeps its identifier. It does not change the password or the addresses: those belong to foliade_set_catalogue_access.

  Parameters:

  • catalogue_id (required) — string
  • guest_token — string

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• foliade_catalogue_stats read-only

  Aggregated statistics: reads and contacts, without disclosing the contact details.

  Parameters:

  • catalogue_id (required) — string
  • days — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• foliade_unpublish_catalogue destructive

  Closes the public link without deleting the data. Requires an explicit request.

  Parameters:

  • catalogue_id (required) — string
  • guest_token — string

  Hints: read-only no · destructive yes · idempotent yes · open-world yes

• foliade_capabilities read-only

  Effective entitlements, JSON schemas and examples. Read before configuring; omitted fields are kept, null is refused. Setting changes are visible immediately on a published catalogue. Binary media, PDF replacements, API keys, REST webhooks, team and billing stay in the workspace/API.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• foliade_get_catalogue_settings read-only

  Settings, table of contents, lead capture, protection without secrets, and the revision needed for changes.

  Parameters:

  • catalogue_id (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• foliade_update_catalogue destructive

  Changes only the fields supplied: colours, bar, controls, sound, reading, logo, title, language, PDF. It never touches the table of contents, which belongs to foliade_set_chapters. dry_run returns a preview without writing. No change to the publication state.

  Parameters:

  • catalogue_id (required) — string
  • patch (required)
  • expected_revision (required) — string
  • dry_run — boolean

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_set_catalogue_access destructive

  Changes access on explicit request only. Never publishes a draft. The password is never returned. This tool sets the password and the addresses; to make a draft public, use foliade_publish_catalogue. Declaring a domain does not configure DNS/TLS; activation remains a separate operation.

  Parameters:

  • catalogue_id (required) — string
  • expected_revision (required) — string
  • domaine
  • dry_run — boolean
  • password — string
  • protection — string
  • sous_domaine

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_set_lead_capture destructive

  Sets activation, page, blocking mode, fields and consent. A plan with lead capture is required; email is mandatory.

  Parameters:

  • catalogue_id (required) — string
  • patch (required)
  • expected_revision (required) — string
  • dry_run — boolean

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_set_chapters destructive

  Replaces the table of contents with the ordered list supplied; an empty list removes it. Only the table of contents: every other reader setting stays with foliade_update_catalogue.

  Parameters:

  • catalogue_id (required) — string
  • chapters (required) — array
  • expected_revision (required) — string
  • dry_run — boolean

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_import_chapters

  Merges the PDF bookmarks into the table of contents without duplicates.

  Parameters:

  • catalogue_id (required) — string
  • expected_revision (required) — string
  • dry_run — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• foliade_get_brand read-only

  Brand name, colour and default PDF download; without any billing information.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• foliade_update_brand destructive

  Account-wide impact: use it when a global customisation is asked for, prefer update_catalogue for a single PDF.

  Parameters:

  • patch (required)
  • expected_revision (required) — string
  • dry_run — boolean

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_list_themes read-only

  Account themes, their settings and revisions; a theme is a copy, not a live link.

  Parameters:

  • limit — integer
  • offset — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• foliade_create_theme

  Saves the existing styling and media of the catalogue as a theme, within the limit of the plan.

  Parameters:

  • catalogue_id (required) — string
  • name (required) — string
  • expected_revision (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• foliade_update_theme destructive

  Changes the theme for its future applications. make_default changes the starting point of new catalogues.

  Parameters:

  • theme_id (required) — integer
  • patch (required)
  • expected_revision (required) — string
  • name
  • dry_run — boolean
  • make_default — boolean

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_apply_theme destructive

  Copies the styling and media of a theme of this account onto this catalogue.

  Parameters:

  • catalogue_id (required) — string
  • theme_id (required) — integer
  • expected_revision (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_get_enrichments read-only

  Elements, published version, differences and revision. The files remain those of the catalogue.

  Parameters:

  • catalogue_id (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• foliade_update_enrichments destructive

  Replaces the draft: 13 types, links, buttons, videos, forms, products, galleries, tours, questions. No element that is invalid or closed off by the plan is accepted. Nothing is published before publish_enrichments. See capabilities and get_enrichments for the examples and the native structure.

  Parameters:

  • catalogue_id (required) — string
  • elements (required) — array
  • expected_revision (required) — string
  • dry_run — boolean

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_publish_enrichments destructive

  Publishes the interactive elements explicitly, with history. Does not publish the catalogue itself.

  Parameters:

  • catalogue_id (required) — string
  • expected_revision (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_restore_enrichments destructive

  Restores a version of this catalogue after re-checking the plan; creates a new history entry.

  Parameters:

  • catalogue_id (required) — string
  • publication_id (required) — integer
  • expected_revision (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_list_shelves read-only

  Paginated list of the shelves and their settings, without passwords.

  Parameters:

  • limit — integer
  • offset — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• foliade_get_shelf read-only

  Settings, catalogues in order, and revision of the shelf.

  Parameters:

  • shelf_id (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• foliade_create_shelf

  Creates a shelf as a draft. The Distributeur plan is required; nothing is published automatically.

  Parameters:

  • name (required) — string
  • patch (required)

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• foliade_update_shelf destructive

  Texts, six layouts, covers, shelf boards, colours, fonts, collections, search and opening.

  Parameters:

  • shelf_id (required) — string
  • patch (required)
  • expected_revision (required) — string
  • dry_run — boolean

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_set_shelf_catalogues destructive

  Replaces the contents of the shelf with this ordered list with collection names. The PDFs themselves are kept.

  Parameters:

  • shelf_id (required) — string
  • items (required) — array
  • expected_revision (required) — string
  • dry_run — boolean

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_set_shelf_access destructive

  Publication and access of the shelf on explicit request only; DNS/TLS remain separate.

  Parameters:

  • shelf_id (required) — string
  • expected_revision (required) — string
  • state — string
  • domaine
  • dry_run — boolean
  • password — string
  • protection — string
  • sous_domaine

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• foliade_list_tracking_links read-only

  Named links of the catalogue owned by the account. Contains the recipients; do not disclose them publicly.

  Parameters:

  • catalogue_id (required) — string
  • limit — integer
  • offset — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• foliade_create_tracking_link

  Creates a named Business link. No email is sent; does not publish the catalogue.

  Parameters:

  • catalogue_id (required) — string
  • recipient (required) — string
  • note — string
  • email — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• foliade_update_tracking_link destructive

  Changes recipient, note, email or active flag; closing is explicit and reversible, with no message sent.

  Parameters:

  • catalogue_id (required) — string
  • link_id (required) — integer
  • patch (required)
  • expected_revision (required) — string
  • dry_run — boolean

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.