How do I install ClicheFactory Document Intelligence?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does ClicheFactory Document Intelligence need an API key?

The publisher lists these environment variables: CLICHEFACTORY_API_KEY, CLICHEFACTORY_API_URL, LLM_MODEL_NAME, LLM_API_KEY, OCR_MODEL_NAME, OCR_API_KEY.

What transport does ClicheFactory Document Intelligence use?

ClicheFactory Document Intelligence runs locally over stdio.

When was ClicheFactory Document Intelligence last checked?

Last checked 2026-11-09. Extract structured JSON from PDFs, images, DOCX, XLSX, CSV, EML attachments, and DSPy pipelines.

ClicheFactory Document Intelligence MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx clichefactory-mcp==0.1.8

Credentials from the publisher

CLICHEFACTORY_API_KEY — ClicheFactory API key for service mode.
CLICHEFACTORY_API_URL — Optional ClicheFactory API base URL override.
LLM_MODEL_NAME — Model name for local mode, for example gemini/gemini-3-flash-preview.
LLM_API_KEY — LLM provider API key for local mode.
OCR_MODEL_NAME — Optional OCR/VLM model override.
OCR_API_KEY — Optional OCR/VLM provider API key.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1CLICHEFACTORY_API_KEY=<secret> CLICHEFACTORY_API_URL=<value> LLM_MODEL_NAME=<value> LLM_API_KEY=<secret> OCR_MODEL_NAME=<value> OCR_API_KEY=<secret> claude mcp add io.github.clichefactory-clichefactory-mcp -- uvx clichefactory-mcp==0.1.8

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.clichefactory-clichefactory-mcp": {4      "command": "uvx",5      "args": [6        "clichefactory-mcp==0.1.8"7      ],8      "env": {9        "CLICHEFACTORY_API_KEY": "<secret>",10        "CLICHEFACTORY_API_URL": "<value>",11        "LLM_MODEL_NAME": "<value>",12        "LLM_API_KEY": "<secret>",13        "OCR_MODEL_NAME": "<value>",14        "OCR_API_KEY": "<secret>"15      }16    }17  }18}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

clichefactory-mcp

MCP (Model Context Protocol) server for ClicheFactory — structured data extraction from documents.

This server exposes ClicheFactory's extraction and document conversion capabilities as MCP tools, allowing AI assistants in Cursor, Claude Desktop, OpenClaw, and other MCP-compatible clients to extract structured data from PDFs, images, DOCX, XLSX, CSV, EML, and more.

Quick start (recommended — service mode)

Service mode uses the ClicheFactory cloud for the best extraction quality. You only need one API key.

Sign up at clichefactory.com — free pages included, no credit card required.
Create an API key in Settings → API Keys (format: cliche-...).
Install the MCP server:
```
pip install clichefactory-mcp
```
Configure — either paste the key into your MCP client (see below) or run once in a terminal:
```
pip install clichefactory   # if you don't have the CLI yet
clichefactory configure
```
The interactive wizard saves credentials to ~/.clichefactory/config.toml, which the MCP server reads automatically.

That's it — one env var (CLICHEFACTORY_API_KEY) or a config file, and you're on hosted extraction.

Tools

Tool	Description
`extract`	Extract structured JSON from a document using a schema
`to_markdown`	Convert a document to markdown text
`doctor`	Check configuration, dependencies, and system binaries

`extract`

The main tool. Pass a document file and a JSON schema — get structured data back.

Supports all extraction modes:

Mode	Description	Requires
(default)	OCR + LLM extraction	Service API key (recommended)
`fast`	Fastest pipeline	Service API key
`trained`	Trained pipeline artifact	Service + `artifact_id`
`robust`	Two-stage extract + verify	Service only
`robust-trained`	Trained extract + verification	Service + `artifact_id`

The schema can be provided as:

File path: absolute path to a .json schema file
Inline dict: the LLM constructs a JSON schema from the conversation (e.g., the user says "extract the invoice number and total" and the LLM builds {"type": "object", "properties": {"invoice_number": {"type": "string"}, "total": {"type": "number"}}})

`to_markdown`

Converts any supported document to markdown. Useful for inspecting document contents or feeding them to the LLM for analysis before deciding on an extraction schema.

`doctor`

Runs diagnostics on the ClicheFactory setup — config file, API keys, Python dependencies, system binaries. Call this when things aren't working.

Execution Modes

The server defaults to service mode (ClicheFactory cloud). Local mode is available for BYOK / air-gapped use.

service (recommended) — Uses the ClicheFactory cloud service. Requires a ClicheFactory API key. Supports all extraction modes including trained pipelines and robust verification. Best extraction quality out of the box.
local (advanced) — Runs extraction on your machine. You bring your own LLM key (BYOK). Requires pip install "clichefactory-mcp[local]" (~2 GB of parsing/OCR dependencies) plus system binaries (tesseract, LibreOffice). Quality depends on your local setup.

Installation

Prerequisites

Python ≥ 3.12
uv (recommended) or pip

From PyPI

pip install clichefactory-mcp

For local-mode extraction (BYOK, runs on your machine), install with the local extras:

pip install "clichefactory-mcp[local]"

Configuration

Environment Variables

Set these in your MCP client configuration (see below) or in ~/.clichefactory/config.toml via clichefactory configure.

Variable	Required	Description
`CLICHEFACTORY_API_KEY`	Yes (service mode)	ClicheFactory API key from Settings → API Keys (`cliche-...`)
`CLICHEFACTORY_API_URL`	No	Override the default service URL (`https://api.clichefactory.com`); useful for local development against a self-hosted ClicheFactory backend
`LLM_MODEL_NAME`	Local mode only	Model name, e.g. `gemini/gemini-3-flash-preview`
`LLM_API_KEY`	Local mode only	API key for the LLM provider
`OCR_MODEL_NAME`	No	Separate OCR/VLM model (defaults to main model)
`OCR_API_KEY`	No	API key for OCR model (defaults to main key)

Environment variables take precedence over the config file at ~/.clichefactory/config.toml.

Cursor

Add to .cursor/mcp.json in your project (or global Cursor settings):

{
  "mcpServers": {
    "clichefactory": {
      "command": "uvx",
      "args": ["clichefactory-mcp"],
      "env": {
        "CLICHEFACTORY_API_KEY": "cliche-your-key-here"
      }
    }
  }
}

For local development from a git checkout, replace uvx with:

"command": "uv",
"args": ["--directory", "/absolute/path/to/cliche-mcp", "run", "clichefactory-mcp"]

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "clichefactory": {
      "command": "uvx",
      "args": ["clichefactory-mcp"],
      "env": {
        "CLICHEFACTORY_API_KEY": "cliche-your-key-here"
      }
    }
  }
}

OpenClaw

openclaw mcp set clichefactory '{"command":"uvx","args":["clichefactory-mcp"],"env":{"CLICHEFACTORY_API_KEY":"cliche-your-key-here"}}'

Verify with openclaw mcp list. The agent can now use extract, to_markdown, and doctor tools in any conversation.

An OpenClaw skill with agent instructions is also available in integrations/openclaw/. To install it into your workspace:

cp -r /path/to/cliche-mcp/integrations/openclaw ~/.openclaw/skills/clichefactory

Or, once published to ClawHub:

openclaw skills install clichefactory

Local mode (advanced)

If you prefer BYOK extraction on your machine, install the local extras and set LLM credentials:

{
  "mcpServers": {
    "clichefactory": {
      "command": "uvx",
      "args": ["clichefactory-mcp"],
      "env": {
        "LLM_MODEL_NAME": "gemini/gemini-3-flash-preview",
        "LLM_API_KEY": "your-gemini-api-key"
      }
    }
  }
}

Pass mode="local" explicitly in tool calls, or run clichefactory configure --local to set local as the default in ~/.clichefactory/config.toml.

Supported File Types

PDF, PNG, JPG, JPEG, WebP, GIF, BMP, DOCX, DOC, ODT, XLSX, CSV, EML, TXT, MD.

Differences from the CLI

This MCP server covers the core extraction and conversion workflows. The following CLI features are not included in v1:

Feature	Reason
Batch operations (`extract-batch`, `to-markdown-batch`)	MCP tools are typically called one-at-a-time by the LLM. For multiple documents, the LLM calls `extract` in sequence. Batch support may be added in a future version.
`configure`	Interactive prompts don't work in MCP. Use env vars or run `clichefactory configure` in a terminal.
`--output` / `-o` flag	MCP tools return results directly to the LLM rather than writing to files.
`allow_partial`	Not exposed as a tool parameter in v1.
OCR engine selection	Uses the SDK defaults (RapidOCR). Configure via `~/.clichefactory/config.toml` or pass parsing options through the SDK if needed.

Development

# Install in development mode
uv sync

# Run the server directly (stdio transport, for testing with MCP clients)
uv run clichefactory-mcp

# Inspect available tools (requires mcp CLI)
uv run mcp dev cliche_mcp/server.py

ClicheFactory Document Intelligence

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install ClicheFactory Document Intelligence?

Does ClicheFactory Document Intelligence need an API key?

What transport does ClicheFactory Document Intelligence use?

When was ClicheFactory Document Intelligence last checked?

Documentation

clichefactory-mcp

Quick start (recommended — service mode)

Tools

`extract`

`to_markdown`

`doctor`

Execution Modes

Installation

Prerequisites

From PyPI

Configuration

Environment Variables

Cursor

Claude Desktop

OpenClaw

Local mode (advanced)

Supported File Types

Differences from the CLI

Development

License