
crispparse-mcp
io.github.goldmarklabs/crispparse-mcp
Deterministic web extraction (Markdown, JSON, CSS selectors) and C2PA v2.4 verification.
Documentation
CrispParse MCP Server
A self-contained Model Context Protocol (stdio) server built with @modelcontextprotocol/sdk that exposes deterministic web extraction (Markdown, JSON, Hybrid, CSS selectors, Tier 2/3 stealth rendering) and C2PA v2.4 provenance verification to MCP-compatible AI agents and desktop clients (Claude Desktop, Cursor, Windsurf, and Cline).
How It Works
This repository implements a local MCP stdio server (index.js) using StdioServerTransport:
- Registers MCP
tools/listandtools/callhandlers via@modelcontextprotocol/sdk. - Auto-provisions a free 50-credit trial Macaroon (
~/.crispparse/trial_token.json) if no API key orx402Base USDC payment header is supplied. - Executes upstream extraction requests against the CrispParse 3-tier waterfall engine (
https://api.crispparse.com/v1/extract) with Zero Payload Retention (ZDR) and returns clean Markdown, structured JSON, and a signed C2PA provenance manifest.
Available Tools
crispparse_extract
Extracts clean, LLM-ready Markdown, structured JSON, or Hybrid output from any public webpage URL across CrispParse's 3-tier waterfall (static HTTP, headless JS rendering, and self-healing CSS selectors).
url(string, required): The fullhttp://orhttps://URL to extract.mode(string, optional, default"markdown"): Output format ("markdown","json", or"hybrid").selectors(object, optional): Map offield_name -> CSS selector(up to 30 fields). Automatically triggers Tier 2 JS rendering and Tier 3 self-healing selector recovery if needed.bypass_cache(boolean, optional, defaultfalse): Settrueto bypass edge cache and force a fresh live extraction.api_key(string, optional): CrispParse Macaroon bearer token (overridesCRISPPARSE_API_KEY).payment_signature(string, optional):x402v2PAYMENT-SIGNATUREBase USDC proof header (overridesCRISPPARSE_PAYMENT_SIGNATURE).
crispparse_claim_trial
Claims or retrieves a cached zero-config CrispParse trial Macaroon token (50 credits, 14-day TTL) for immediate extraction without manual signup.
force_refresh(boolean, optional, defaultfalse): Request a fresh trial token instead of returning the cached token.
crispparse_verify
Cryptographically verifies a detached C2PA v2.4 provenance manifest returned by crispparse_extract against https://api.crispparse.com/v1/verify.
provenance(object, required): Theprovenanceobject from a CrispParse extraction response.
MCP Client Configuration
Zero-Install via npx (Recommended)
Add the server to your Claude Desktop (claude_desktop_config.json) or Cursor MCP configuration:
{
"mcpServers": {
"crispparse": {
"command": "npx",
"args": ["-y", "crispparse-mcp@1.0.3"]
}
}
}
Run from Local Clone (Node.js v18+)
git clone https://github.com/goldmarklabs/crispparse-mcp.git
cd crispparse-mcp
npm install
CRISPPARSE_API_KEY="your_api_key" node index.js
Run with Docker
docker build -t crispparse-mcp .
docker run -i --rm -e CRISPPARSE_API_KEY="your_api_key" crispparse-mcp
Environment Variables
CRISPPARSE_API_KEY: Optional Bearer Macaroon API key from crispparse.com.CRISPPARSE_AUTO_CLAIM_TRIAL: Set"false"to disable automatic trial token provisioning (defaults to"true", falling back to anx402Base USDC payment challenge when unauthenticated).CRISPPARSE_PAYMENT_SIGNATURE: Optional defaultx402v2PAYMENT-SIGNATUREBase USDC proof header.CRISPPARSE_API_URL: Optional upstream endpoint override (defaults tohttps://api.crispparse.com/v1/extract).
License
MIT — see LICENSE.
crispparse-mcpnpm install crispparse-mcp