# Docparser — how to use (mcp.ai)

Connect your Docparser account and use 4 tools for documents straight from your AI agent. Connect with your own API key. Docparser is the most advanced cloud based document parsing and automation tool in the market today.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/docparser/get/multiple/document/results` — Tool to retrieve parsed data from multiple documents processed by a specific parser. Use when you need to fetch results for multiple documents at once. Returns up to 100 results by default, with a max
  - body: { date?: string, list?: string, limit?: integer, format?: string, sort_by?: string, parser_id: string, remote_id?: string, sort_order?: string, include_processing_queue?: boolean }
- `POST https://api.mcp.ai/api/docparser/get/parser/models` — Tool to retrieve all model layouts for a specific parser. Use when you need to list different layout configurations within a parser that help handle document variations.
  - body: { parser_id: string }
- `POST https://api.mcp.ai/api/docparser/list/parsers` — Tool to retrieve all Document Parsers linked to your account. Use when you need to view available parsers or obtain parser IDs for subsequent operations.
- `POST https://api.mcp.ai/api/docparser/ping` — Tool to test API authentication and connection health check for Docparser API. Use when you need to verify that API credentials are valid and the connection is working.

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

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