Extract a financial document
Route the document through the ParseRail tool that matches its type. The specialized tools return richer, schema-validated JSON and most of them cost fewer credits than generic parsing.
1. Pick the tool
| Document |
Tool |
Output |
Credits |
| Invoice |
kynth_invoice |
vendor, dates, PO refs, tax, totals, line items |
8 |
| Receipt |
kynth_receipt |
merchant, items, totals, payment method, expense category |
6 |
| Bank or card statement |
kynth_statement |
account, period, balances, every transaction as a normalized row |
12 |
| Tables in any document, scanned included |
kynth_tables |
every table as clean headers and rows |
8 |
| Resume or CV |
kynth_resume |
contact, skills, experience, education, links |
8 |
| Contract |
kynth_contract |
parties, effective date, term, renewal, governing law, obligations, risk clauses |
12 |
| Unknown or other (EOB, ERA, COI) |
kynth_parse |
structured fields, with an optional docType hint such as "invoice" |
10 |
| Multi-document scan bundle |
kynth_split |
what each document is and where it starts and ends, then extract each piece |
10 |
| Two versions of one document |
kynth_compare |
every material change, what it means, the risk it carries |
15 |
If the user needs the output in their own shape, run the extraction tool first, then pass the result through kynth_structure with their JSON Schema. It validates against required fields and property types, retries once correctively, and returns a valid flag. That is 6 more credits.
2. Pass the document
Every tool above takes exactly ONE of these input forms:
fileUrl, a public URL to the PDF or imagetext, raw text if the content is already in the conversationfileBase64 plus fileMimeType, for local files: read the file, base64-encode it, and pass both fields. fileMimeType has to be right, for example application/pdf, image/png, image/jpeg.
For a local file, encode it in one step:
base64 -i path/to/invoice.pdf
Do not pass a local filesystem path as fileUrl. That field has to be publicly reachable. Passing none of the three forms returns Provide one of: fileUrl, text, or fileBase64 + fileMimeType.
3. What comes back
Each tool returns schema-validated JSON for its document type. The API validates the extraction against the endpoint's schema before returning it, so fields are typed and consistent across calls. Alongside the result comes usage: { credits, balanceRemaining }.
Present the parts the user asked for. Offer the full JSON if they want to pipe it somewhere.
Billing
Calls debit the account credit wallet only on success. A failed call (bad input, timeout, server error) costs nothing, so a retry is safe. 1 credit = $0.01; the per-tool rates are in the table above.
There is no free tier. A wallet starts at zero and is topped up by a credit pack or a monthly plan bought at https://api.kynth.studio. A call that the wallet cannot cover returns 402 insufficient_credits before any model runs, so it costs nothing and answers immediately.
1---2name: extract-financial-doc3description: Extract structured data from a financial document (invoice, receipt, bank or card statement, resume, contract, or embedded tables) using the ParseRail MCP tools. Use when the user wants line items, totals, transactions, or tables pulled out of a PDF, an image, or pasted text as clean JSON.4---56# Extract a financial document78Route the document through the ParseRail tool that matches its type. The specialized tools return richer, schema-validated JSON and most of them cost fewer credits than generic parsing.910## 1. Pick the tool1112| Document | Tool | Output | Credits |13| --- | --- | --- | --- |14| Invoice | `kynth_invoice` | vendor, dates, PO refs, tax, totals, line items | 8 |15| Receipt | `kynth_receipt` | merchant, items, totals, payment method, expense category | 6 |16| Bank or card statement | `kynth_statement` | account, period, balances, every transaction as a normalized row | 12 |17| Tables in any document, scanned included | `kynth_tables` | every table as clean headers and rows | 8 |18| Resume or CV | `kynth_resume` | contact, skills, experience, education, links | 8 |19| Contract | `kynth_contract` | parties, effective date, term, renewal, governing law, obligations, risk clauses | 12 |20| Unknown or other (EOB, ERA, COI) | `kynth_parse` | structured fields, with an optional `docType` hint such as `"invoice"` | 10 |21| Multi-document scan bundle | `kynth_split` | what each document is and where it starts and ends, then extract each piece | 10 |22| Two versions of one document | `kynth_compare` | every material change, what it means, the risk it carries | 15 |2324If the user needs the output in their own shape, run the extraction tool first, then pass the result through `kynth_structure` with their JSON Schema. It validates against required fields and property types, retries once correctively, and returns a `valid` flag. That is 6 more credits.2526## 2. Pass the document2728Every tool above takes exactly ONE of these input forms:2930- `fileUrl`, a public URL to the PDF or image31- `text`, raw text if the content is already in the conversation32- `fileBase64` plus `fileMimeType`, for local files: read the file, base64-encode it, and pass both fields. `fileMimeType` has to be right, for example `application/pdf`, `image/png`, `image/jpeg`.3334For a local file, encode it in one step:3536```bash37base64 -i path/to/invoice.pdf38```3940Do not pass a local filesystem path as `fileUrl`. That field has to be publicly reachable. Passing none of the three forms returns `Provide one of: fileUrl, text, or fileBase64 + fileMimeType.`4142## 3. What comes back4344Each tool returns schema-validated JSON for its document type. The API validates the extraction against the endpoint's schema before returning it, so fields are typed and consistent across calls. Alongside the result comes `usage: { credits, balanceRemaining }`.4546Present the parts the user asked for. Offer the full JSON if they want to pipe it somewhere.4748## Billing4950Calls debit the account credit wallet only on success. A failed call (bad input, timeout, server error) costs nothing, so a retry is safe. 1 credit = $0.01; the per-tool rates are in the table above.5152There is no free tier. A wallet starts at zero and is topped up by a credit pack or a monthly plan bought at https://api.kynth.studio. A call that the wallet cannot cover returns `402 insufficient_credits` before any model runs, so it costs nothing and answers immediately.
kyisaiah47