# CapyParse

> CapyParse converts PDF bank statements (including scans and photos) into verified, structured transaction data. Alongside the web app it offers a REST API and an MCP server built for AI agents: start a conversion with one POST, poll until it completes, then read normalized transactions as JSON, CSV, Markdown, or JSONL. Every transaction carries a page and line citation (like p3:L14) plus the verbatim statement text, and each account is verified with balance reconciliation, net change, and completeness checks. Pricing is 1 credit per statement page.

## Documentation

- [Developer docs](https://capyparse.com/developers): Quickstart, endpoint reference, response formats, provenance, credits, rate limits, and error codes for the agent API.

## API

- [API base URL](https://capyparse.com/api/v1): REST API. Authenticate every request with `Authorization: Bearer cpk_live_...` (team-scoped API key created in the CapyParse dashboard). Key endpoints: `GET /me` (plan and credits), `POST /conversions` (start a conversion, 202), `GET /conversions/{id}` (status), `GET /conversions/{id}/result?format=json|csv|markdown|jsonl` (result).

## MCP

- [Hosted MCP server](https://capyparse.com/mcp): Streamable HTTP MCP server; send the same `Authorization: Bearer cpk_live_...` header. Tools: convert_bank_statement, get_conversion, get_conversion_result, list_conversions, get_credits.
- [capyparse-mcp on npm](https://www.npmjs.com/package/capyparse-mcp): Local stdio MCP server (`npx -y capyparse-mcp`, configured with the CAPYPARSE_API_KEY environment variable) that can also convert local files by path.

## Product

- [Homepage](https://capyparse.com/): Free in-browser bank statement converter with instant demo.
- [Pricing](https://capyparse.com/pricing): Plans and credits; 1 credit converts 1 page.