Suparse
Overview
What is Suparse MCP Server?
Suparse MCP Server is a Model Context Protocol connector for the Suparse Document Processing API, enabling AI assistants to extract structured data from local PDFs and images without writing upload, polling, or export code.
How to use Suparse MCP Server?
To use the server, install it with npx, create a Suparse API key, configure an MCP-compatible client such as Claude Code, Claude Desktop, or Codex with SUPARSE_API_KEY, restart the client, and ask your assistant to process local documents.
Key features of Suparse MCP Server?
- AI-powered extraction from invoices, receipts, bank statements, purchase orders, and other supported document types.
- Batch processing for local folders of supported documents.
- Template listing so assistants can choose the right extraction schema.
- Result downloads as JSON, CSV, XLSX, or Google Sheets.
- Document cleanup support for privacy-sensitive workflows.
- Integration with Claude Code, Claude Desktop, Codex, and other MCP-compatible clients.
Use cases of Suparse MCP Server?
- Extracting totals, line items, vendor details, and dates from invoices or receipts inside an AI assistant workflow.
- Processing folders of financial, logistics, HR, healthcare, or business documents without building a custom parser.
- Exporting structured document data to spreadsheets for accounting, operations, or review workflows.
- Letting AI coding assistants use Suparse templates and extraction results while working on local files.
- Cleaning up processed documents after downloading results for privacy-conscious document workflows.
FAQ from Suparse MCP Server?
How do I get a Suparse API key?
Sign in at suparse.com, open the API Keys tab, generate a new key, and copy it securely because the key value is shown only once.
What clients can use Suparse MCP Server?
Suparse MCP Server works with MCP-compatible local clients, including Claude Code, Claude Desktop, Codex, and other assistants that support Model Context Protocol servers.
What file types can Suparse process through MCP?
Suparse can process supported local PDFs and images, including common document workflows for invoices, receipts, bank statements, purchase orders, and other business documents.
Can Suparse MCP Server export results?
Yes, assistants can download extraction results as JSON, CSV, XLSX, or Google Sheets when supported by the account workflow.
Can processed documents be deleted after extraction?
Yes, ask the assistant to download the result first and then delete the processed document from Suparse when cleanup is required.
What should I do if Suparse tools do not appear in my assistant?
Restart the MCP client after editing its configuration, confirm Node.js 20 or newer is installed, and verify that SUPARSE_API_KEY is set correctly.
Server Config
{
"mcpServers": {
"suparse": {
"command": "npx",
"args": [
"-y",
"@suparse/mcp"
],
"env": {
"SUPARSE_API_KEY": "<YOUR_API_KEY>"
}
}
}
}