CapyParse MCP Server
Convert PDF bank statements into verified, structured data (Markdown, JSON, CSV, JSONL) from any MCP-compatible AI agent. Every transaction comes with source citations (page/line of the original statement) and balance-verification checks, so agents can audit the numbers they use.
Get an API key at capyparse.com/dashboard/settings/api-keys. Conversions cost 1 credit per page (new accounts include free credits).
Two ways to connect
Hosted (no install) — streamable HTTP:
URL: https://capyparse.com/mcp
Header: Authorization: Bearer cpk_live_...
Local (this package) — runs on your machine, so agents can convert local files by path:
CAPYPARSE_API_KEY=cpk_live_... npx -y capyparse-mcp
Install
Claude Code
claude mcp add capyparse -e CAPYPARSE_API_KEY=cpk_live_... -- npx -y capyparse-mcp
# or hosted:
claude mcp add --transport http capyparse https://capyparse.com/mcp \
--header "Authorization: Bearer cpk_live_..."
Claude Desktop / Cursor / Windsurf
{
"mcpServers": {
"capyparse": {
"command": "npx",
"args": ["-y", "capyparse-mcp"],
"env": { "CAPYPARSE_API_KEY": "cpk_live_..." }
}
}
}
Tools
Example
"Convert ~/Downloads/chase-january.pdf and give me the transactions as CSV."
The agent calls convert_bank_statement(file_path=...), polls
get_conversion, then get_conversion_result(format="csv").
Docs: capyparse.com/developers
Releasing (maintainers)
Future releases: bump with npm version patch (or minor), then npm publish.