Skip to content
Back to search

crispparse-mcp

Official MCP server wrapper for CrispParse — deterministic web extraction & x402 AI-agent commerce API by GoldmarkLabs.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/goldmarklabs--crispparse-mcp/badge.svg)](/listings/goldmarklabs--crispparse-mcp)

HTML

<a href="/listings/goldmarklabs--crispparse-mcp"><img src="/api/listings/goldmarklabs--crispparse-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

plugin.json · Manifest · 1 lines
  1. {"name":"crispparse","description":"Deterministic web extraction and C2PA provenance verification.","version":"1.0.4","mcpServers":"./.mcp.json"}
README.md · README · 77 lines
  1. # CrispParse MCP Server
  2. [![CrispParse MCP Server MCP server – quality and maintenance score on Glama](https://glama.ai/mcp/servers/goldmarklabs/crispparse-mcp/badges/card.svg)](https://glama.ai/mcp/servers/goldmarklabs/crispparse-mcp)
  3. 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).
  4. ## How It Works
  5. This repository implements a local MCP `stdio` server (`index.js`) using `StdioServerTransport`:
  6. 1. Registers MCP `tools/list` and `tools/call` handlers via `@modelcontextprotocol/sdk`.
  7. 2. Auto-provisions a free 50-credit trial Macaroon (`~/.crispparse/trial_token.json`) if no API key or `x402` Base USDC payment header is supplied.
  8. 3. 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.
  9. ## Available Tools
  10. ### `crispparse_extract`
  11. 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).
  12. * **`url`** (`string`, required): The full `http://` or `https://` URL to extract.
  13. * **`mode`** (`string`, optional, default `"markdown"`): Output format (`"markdown"`, `"json"`, or `"hybrid"`).
  14. * **`selectors`** (`object`, optional): Map of `field_name -> CSS selector` (up to 30 fields). Automatically triggers Tier 2 JS rendering and Tier 3 self-healing selector recovery if needed.
  15. * **`bypass_cache`** (`boolean`, optional, default `false`): Set `true` to bypass edge cache and force a fresh live extraction.
  16. * **`api_key`** (`string`, optional): CrispParse Macaroon bearer token (overrides `CRISPPARSE_API_KEY`).
  17. * **`payment_signature`** (`string`, optional): `x402` v2 `PAYMENT-SIGNATURE` Base USDC proof header (overrides `CRISPPARSE_PAYMENT_SIGNATURE`).
  18. ### `crispparse_claim_trial`
  19. Claims or retrieves a cached zero-config CrispParse trial Macaroon token (50 credits, 14-day TTL) for immediate extraction without manual signup.
  20. * **`force_refresh`** (`boolean`, optional, default `false`): Request a fresh trial token instead of returning the cached token.
  21. ### `crispparse_verify`
  22. Cryptographically verifies a detached C2PA v2.4 provenance manifest returned by `crispparse_extract` against `https://api.crispparse.com/v1/verify`.
  23. * **`provenance`** (`object`, required): The `provenance` object from a CrispParse extraction response.
  24. ## MCP Client Configuration
  25. ### Zero-Install via `npx` (Recommended)
  26. Add the server to your Claude Desktop (`claude_desktop_config.json`) or Cursor MCP configuration:
  27. ```json
  28. {
  29. "mcpServers": {
  30. "crispparse": {
  31. "command": "npx",
  32. "args": ["-y", "crispparse-mcp@1.0.3"]
  33. }
  34. }
  35. }
  36. ```
  37. ### Run from Local Clone (Node.js v18+)
  38. ```bash
  39. git clone https://github.com/goldmarklabs/crispparse-mcp.git
  40. cd crispparse-mcp
  41. npm install
  42. CRISPPARSE_API_KEY="your_api_key" node index.js
  43. ```
  44. ### Run with Docker
  45. ```bash
  46. docker build -t crispparse-mcp .
  47. docker run -i --rm -e CRISPPARSE_API_KEY="your_api_key" crispparse-mcp
  48. ```
  49. ## Environment Variables
  50. * `CRISPPARSE_API_KEY`: Optional Bearer Macaroon API key from [crispparse.com](https://crispparse.com).
  51. * `CRISPPARSE_AUTO_CLAIM_TRIAL`: Set `"false"` to disable automatic trial token provisioning (defaults to `"true"`, falling back to an `x402` Base USDC payment challenge when unauthenticated).
  52. * `CRISPPARSE_PAYMENT_SIGNATURE`: Optional default `x402` v2 `PAYMENT-SIGNATURE` Base USDC proof header.
  53. * `CRISPPARSE_API_URL`: Optional upstream endpoint override (defaults to `https://api.crispparse.com/v1/extract`).
  54. ## License
  55. MIT — see [LICENSE](./LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.