Extract structured JSON from PDFs, images, DOCX, XLSX, CSV, EML attachments, and DSPy pipelines.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"clichefactory": {
"env": {
"LLM_API_KEY": "your-gemini-api-key",
"LLM_MODEL_NAME": "gemini/gemini-3-flash-preview"
},
"args": [
"--directory",
"/absolute/path/to/cliche-mcp",
"run",
"clichefactory-mcp"
],
"command": "uv"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
MCP (Model Context Protocol) server for ClicheFactory — structured data extraction from documents.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'clichefactory-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked clichefactory-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in writing
【Star-crossed coders unite!⭐️】Model Context Protocol (MCP) server implementation providing Google News search capabilities via SerpAPI, with automatic news categorization and multi-language support.
URL to LLM-ready markdown — plus per-page category, page_structure, and query-driven highlights.
AI prompt optimization for 58+ platforms across 7 categories with custom platforms
MCP server for LayerOne DocX (documents & Factur-X) and Sign (e-signature) APIs.
MCP Security Weekly
Get CVE alerts and security updates for io.github.ClicheFactory/clichefactory-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
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.
| 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 |
extractThe 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:
.json schema file{"type": "object", "properties": {"invoice_number": {"type": "string"}, "total": {"type": "number"}}})to_markdownConverts any supported document to markdown. Useful for inspecting document contents or feeding them to the LLM for analysis before deciding on an extraction schema.
doctorRuns diagnostics on the ClicheFactory setup — config file, API keys, Python dependencies, system binaries. Call this when things aren't working.
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.
pip install clichefactory-mcp
For local-mode extraction (BYOK, runs on your machine), install with the local extras:
pip install "clichefactory-mcp[local]"
Set these in your MCP client configuration (see below) or in ~/.clichefactory/config.toml via clichefactory configure.
| Variable | Required | Description | |----------|----