# Eagle doc — how to use (mcp.ai)

Connect your Eagle doc account and use 10 tools for document data extraction straight from your AI agent. Connect with your own API key. AI-Powered, Fast, Reliable and Accurate Invoice OCR and Receipt OCR API for Seamless Integration.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_eagle_doc?ms=1787293440000`
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. `eagle_doc_any_doc_ocr`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/eagle_doc`
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/eagle_doc/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/eagle_doc/any/doc/ocr` — Tool to process any document type with OCR and automatic classification. Supports bank statements, resumes, passports, delivery sheets, and more. Use when you need to extract structured data from vari
  - body: { file: object, docType?: string, privacy?: boolean, configId?: string }
- `POST https://api.mcp.ai/api/eagle_doc/batch/any/doc/ocr` — Tool to submit batch OCR processing tasks for various document types including bank statements, resumes, passports, delivery sheets, and more. Use when you need to asynchronously process documents wit
  - body: { file?: object, privacy?: boolean, doc_type?: string, file_url?: string, config_id?: string }
- `POST https://api.mcp.ai/api/eagle_doc/batch/task/delete` — Tool to delete a submitted batch processing task from the queue. Use when you need to cancel or remove a previously submitted batch OCR task before processing completes.
  - body: { taskId: string }
- `POST https://api.mcp.ai/api/eagle_doc/invoice/ocr/base64` — Tool to extract invoice data from base64 encoded images using Eagle Doc OCR API. Use when you need to process invoice images that are already base64 encoded. Supports optional parameters for privacy c
  - body: { polygon?: boolean, privacy?: boolean, fullText?: boolean, base64_image: string }
- `POST https://api.mcp.ai/api/eagle_doc/management/quota` — Tool to get contractual quota allowance and current usage counters for all workloads. Use when you need to check remaining capacity for dashboards or billing workflows.
- `POST https://api.mcp.ai/api/eagle_doc/receipt/ocr/v3` — Tool to process receipt images into structured JSON with 40+ fields including merchant info, line items, taxes, and payments. Use when extracting detailed data from receipt images or PDFs.
  - body: { file?: object, speed?: boolean, polygon?: boolean, privacy?: boolean, file_url?: string, fullText?: boolean }
- `POST https://api.mcp.ai/api/eagle_doc/receipt/quota/v2` — Tool to get quota information for receipt processing API v2 (deprecated). Use when you need to check available quota and usage for receipt OCR processing. Note: Multi-page receipts count each page as 
- `POST https://api.mcp.ai/api/eagle_doc/usage/current/month` — Tool to get current month's usage statistics including quota, pages processed, over-usage, and costs. Use when you need to check API usage and billing information for the current billing period.
- `POST https://api.mcp.ai/api/eagle_doc/usage/monthly/history` — Tool to retrieve historical monthly usage data with pricing context for reconciliation and forecasting. Use when you need to analyze page processing trends or calculate costs.
- `POST https://api.mcp.ai/api/eagle_doc/usage/request/logs` — Tool to retrieve chronological list of recent API calls with page counts and timestamps. Use for troubleshooting and auditing consumption patterns.

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

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