@parserelay/mcp
OfficialAllows parsing documents into structured fields using the ParseRelay scan API, with confidence scoring and field-level metadata.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@parserelay/mcp Scan this receipt for total, date, and merchant with confidence scores."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@parserelay/mcp
ParseRelay's scan operation as an MCP tool — so any
MCP host (Claude Desktop, Cursor, …) can parse a document into structured, confidence-scored
fields. Same contract as the REST API and the <DeadSimpleMicroScanner> component; one tool,
scan.
The scan tool
Input mirrors the sync ScanRequest — image (required), plus
schema, doc_type, engine, ocr, dry_run, model, model_key. (relay webhooks are
omitted: a tool call is synchronous, so you get the envelope back inline.) The result is the
full ScanEnvelope as JSON: fields, per-field confidence,
needs_review, field_source, and meta (engine, credits, tokens).
Set dry_run: true to preview which fields would trigger a paid rescue — and the estimated
credits — without spending anything.
Related MCP server: OCR MCP Server
Run it
stdio (Claude Desktop, Cursor)
{
"mcpServers": {
"parserelay": {
"command": "npx",
"args": ["-y", "@parserelay/mcp"],
"env": {
"PARSERELAY_API_KEY": "your-key",
"PARSERELAY_BASE_URL": "https://api.parserelay.app" // optional
}
}
}
}streamable-HTTP (remote / hosted)
PARSERELAY_API_KEY=your-key PORT=8080 node node_modules/@parserelay/mcp/dist/http.js
# → POST http://localhost:8080/mcpStateless: a fresh server per request, so it scales horizontally. Auth per request via
Authorization: Bearer <key>, falling back to PARSERELAY_API_KEY for single-tenant setups.
Programmatic
import { createMcpServer } from "@parserelay/mcp";
import { ParseRelayClient } from "@parserelay/client";
const server = createMcpServer(new ParseRelayClient({ apiKey }));
// then wire your own transport: await server.connect(transport)Config
Env var | Required | Default | Notes |
| stdio: yes | — | HTTP can override per request via |
| no |
| Point at a local worker for testing. |
| no |
| HTTP transport only. |
Available Tools
1 toolscanScan a documentA
Parse a document (receipt, invoice, form, ID) into structured, confidence-scored fields. Returns the ParseRelay envelope: fields, per-field confidence, needs_review, field_source provenance, and meta (engine, credits, tokens). Set dry_run: true to preview cost without spending.
Inputs: image (required), ocr, model, engine, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
Only one tool exists, so there is no possibility of confusion between overlapping tools. The tool's purpose is clearly defined and distinct.
The single tool name 'scan' is simple, descriptive, and follows a consistent verb-based naming style. There are no mixed conventions or conflicting patterns.
The server has only one tool, which is appropriate for its narrow scope as a document parser. While the count is lower than the typical 3-15 range, the tool covers the core functionality without feeling overly thin.
The 'scan' tool fully addresses the apparent domain of document parsing, including dry-run support for cost preview. No obvious missing operations are evident from the description.
Related MCP Connectors
Agent-native document parsing: PDF, scans and FR/EU invoices to structured JSON or Markdown.
Turn PDFs and photos into typed JSON with your own schema. Missing values come back null.
Turn messy text into strict JSON schemas agents can trust (invoice, receipt, contact, resume).
High-fidelity PDF to structured Markdown conversion and document field extraction.
Related MCP Servers
AlicenseAqualityBmaintenanceEnables Claude and other MCP-compatible agents to process documents, extract structured data, detect PII, and export LLM-ready datasets through natural language tool calls.825 PyPI1MIT- AlicenseNot gradedqualityDmaintenanceEnables document text recognition and extraction from images and PDFs using Claude Vision, including support for scanned documents and structured output, without requiring local OCR engines.MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables deterministic extraction and validation of structured JSON data from inputs using a defined schema. It plugs into MCP-compatible clients like Claude Desktop, Cursor, and Windsurf to return standardized, schema-validated results.-
- AlicenseAqualityCmaintenanceEnables Claude, Cursor, VS Code, and other MCP clients to extract data from INE/IFE voting credentials and create one-time capture links so clients can photograph their document from a phone.336 npmMIT