# Veryfi OCR — how to use (mcp.ai)

Connect your Veryfi OCR account and use 5 tools for document data extraction straight from your AI agent. Connect with your own API key. Veryfi extracts structured data from receipts, invoices, bank statements, tax forms, checks, business cards, and other documents.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_veryfi?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `veryfi_delete_document`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/veryfi`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/veryfi/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/veryfi/delete/document` — Permanently delete one Veryfi receipt or invoice by document id.
  - body: { document_id: integer }
- `POST https://api.mcp.ai/api/veryfi/get/document` — Retrieve one processed receipt or invoice and all extracted OCR fields by its Veryfi document ID.
  - body: { document_id: integer, bounding_boxes?: boolean, confidence_details?: boolean }
- `POST https://api.mcp.ai/api/veryfi/process/document` — Submit one receipt or invoice to Veryfi OCR by public URL or base64 content. Choose synchronous processing to return extracted data now or asynchronous processing to return an id for later retrieval. 
  - body: { tags?: string[], file_url?: string, file_data?: string, file_name?: string, categories?: string[], external_id?: string, bounding_boxes?: boolean, processing_mode?: string, confidence_details?: boolean, max_pages_to_process?: integer }
- `POST https://api.mcp.ai/api/veryfi/search/documents` — List or search processed receipts and invoices using text, identifiers, tags, status, or date ranges, returning one controllable page.
  - body: { tag?: string, query?: string, status?: string, order_by?: string, page_size?: integer, external_id?: string, next_cursor?: string, created_after?: string, bounding_boxes?: boolean, created_before?: string, confidence_details?: boolean, document_date_after?: string, track_total_results?: boolean, document_date_before?: string }
- `POST https://api.mcp.ai/api/veryfi/update/document` — Correct practical metadata and review flags on a processed receipt or invoice. Provide at least one of external_id, notes, is_approved, or is_duplicate; only explicitly provided fields are changed.
  - body: { notes?: string, document_id: integer, external_id?: string, is_approved?: boolean, is_duplicate?: boolean }

## Example prompts
- "What can I do in Veryfi OCR?"
- "Show me a summary of my Veryfi OCR account"

## More
- Page: https://mcp.ai/veryfi
- Agent spec (llms.txt): https://mcp.ai/veryfi/llms.txt
- Postman collection: https://mcp.ai/veryfi/postman.json