Docparser MCP by usefulapi is an MCP server published by io.usefulapi, hosted at docparser.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 9 tools, including docparser_ping, docparser_list_parsers, docparser_list_parser_models, docparser_get_document_status, docparser_get_document_results.
Run Docparser parsers: import documents by URL or upload, check status, read parsed results.
3,922 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Check that the connected Docparser API key works. Returns {msg: "pong"} when it does. GET /v1/ping.
No parameters.
{
"name": "docparser_ping",
"title": "Check API key",
"description": "Check that the connected Docparser API key works. Returns {msg: \"pong\"} when it does. GET /v1/ping.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Check API key",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
List all Document Parsers on the account (id and label). Start here: the parser id is needed by every other tool. GET /v1/parsers.
No parameters.
{
"name": "docparser_list_parsers",
"title": "List parsers",
"description": "List all Document Parsers on the account (id and label). Start here: the parser id is needed by every other tool. GET /v1/parsers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List parsers",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the model layouts of one parser (id and label). GET /v1/parser/models/{parser_id}.
| Parameter | Type | Description |
|---|---|---|
| parser_id * | string | Docparser parser id (from docparser_list_parsers). |
{
"name": "docparser_list_parser_models",
"title": "List parser model layouts",
"description": "List the model layouts of one parser (id and label). GET /v1/parser/models/{parser_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"parser_id"
],
"properties": {
"parser_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Docparser parser id (from docparser_list_parsers)."
}
}
},
"annotations": {
"title": "List parser model layouts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Processing status of one document: importing/processing flags, page count, timestamps (uploaded, imported, processed), webhook dispatch and failed jobs. Poll this after a fetch/upload: the document is done when importing_in_progress and processing_in_progress are false, processed_at is set and failed_jobs is empty (a non-empty failed_jobs means it failed); then read the results. GET /v2/document/status/{parser_id}/{document_id}.
| Parameter | Type | Description |
|---|---|---|
| parser_id * | string | Docparser parser id (from docparser_list_parsers). |
| document_id * | string | Docparser document id (the `id` / `document_id` of an uploaded document). |
{
"name": "docparser_get_document_status",
"title": "Get document status",
"description": "Processing status of one document: importing/processing flags, page count, timestamps (uploaded, imported, processed), webhook dispatch and failed jobs. Poll this after a fetch/upload: the document is done when importing_in_progress and processing_in_progress are false, processed_at is set and failed_jobs is empty (a non-empty failed_jobs means it failed); then read the results. GET /v2/document/status/{parser_id}/{document_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"parser_id",
"document_id"
],
"properties": {
"parser_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Docparser parser id (from docparser_list_parsers)."
},
"document_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Docparser document id (the `id` / `document_id` of an uploaded document)."
}
}
},
"annotations": {
"title": "Get document status",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The parsed data of one document (the fields and tables the parser extracted, plus file name, page count and upload/processing times). Docparser allows 60 of these calls per minute. GET /v1/results/{parser_id}/{document_id}.
| Parameter | Type | Description |
|---|---|---|
| format | string | `object` (default): nested data. `flat`: simple key/value pairs. |
| parser_id * | string | Docparser parser id (from docparser_list_parsers). |
| document_id * | string | Docparser document id (the `id` / `document_id` of an uploaded document). |
| include_children | boolean | Also return data of child documents created during preprocessing (for example split documents). |
{
"name": "docparser_get_document_results",
"title": "Get parsed data of one document",
"description": "The parsed data of one document (the fields and tables the parser extracted, plus file name, page count and upload/processing times). Docparser allows 60 of these calls per minute. GET /v1/results/{parser_id}/{document_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"parser_id",
"document_id"
],
"properties": {
"format": {
"enum": [
"object",
"flat"
],
"type": "string",
"description": "`object` (default): nested data. `flat`: simple key/value pairs."
},
"parser_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Docparser parser id (from docparser_list_parsers)."
},
"document_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Docparser document id (the `id` / `document_id` of an uploaded document)."
},
"include_children": {
"type": "boolean",
"description": "Also return data of child documents created during preprocessing (for example split documents)."
}
}
},
"annotations": {
"title": "Get parsed data of one document",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Parsed data of several documents of one parser: the last uploaded ones (default), or those uploaded/processed after a date. Returns up to 100 documents per call; page with offset (next_offset is null on the last page). Docparser allows 30 of these calls per minute. GET /v1/results/{parser_id}.
| Parameter | Type | Description |
|---|---|---|
| date | string | ISO 8601 date-time (e.g. 2026-10-01T00:00:00Z) or a Unix timestamp. Required with list=uploaded_after or processed_after. |
| list | string | Which documents (default last_uploaded). uploaded_after and processed_after need `date`. |
| limit | integer | Documents per call, 1-100 (default 10). |
| format | string | `object` (default): nested data. `flat`: simple key/value pairs. |
| offset | integer | Skip this many documents (default 0). Pass the previous reply's next_offset. |
| sort_by | string | Sort field (default: upload order). |
| parser_id * | string | Docparser parser id (from docparser_list_parsers). |
| remote_id | string | Only documents uploaded with this remote_id. |
| sort_order | string | Default DESC. |
| include_processing_queue | boolean | Also include documents that are not fully processed yet. |
{
"name": "docparser_list_document_results",
"title": "List parsed data of many documents",
"description": "Parsed data of several documents of one parser: the last uploaded ones (default), or those uploaded/processed after a date. Returns up to 100 documents per call; page with offset (next_offset is null on the last page). Docparser allows 30 of these calls per minute. GET /v1/results/{parser_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"parser_id"
],
"properties": {
"date": {
"type": "string",
"maxLength": 40,
"minLength": 8,
"description": "ISO 8601 date-time (e.g. 2026-10-01T00:00:00Z) or a Unix timestamp. Required with list=uploaded_after or processed_after."
},
"list": {
"enum": [
"last_uploaded",
"uploaded_after",
"processed_after"
],
"type": "string",
"description": "Which documents (default last_uploaded). uploaded_after and processed_after need `date`."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Documents per call, 1-100 (default 10)."
},
"format": {
"enum": [
"object",
"flat"
],
"type": "string",
"description": "`object` (default): nested data. `flat`: simple key/value pairs."
},
"offset": {
"type": "integer",
"maximum": 100000,
"minimum": 0,
"description": "Skip this many documents (default 0). Pass the previous reply's next_offset."
},
"sort_by": {
"enum": [
"parsed_at",
"processed_at",
"uploaded_at",
"first_processed_at",
"imported_at",
"integrated_at",
"dispatched_webhook_at",
"preprocessed_at"
],
"type": "string",
"description": "Sort field (default: upload order)."
},
"parser_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Docparser parser id (from docparser_list_parsers)."
},
"remote_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only documents uploaded with this remote_id."
},
"sort_order": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Default DESC."
},
"include_processing_queue": {
"type": "boolean",
"description": "Also include documents that are not fully processed yet."
}
}
},
"annotations": {
"title": "List parsed data of many documents",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: ask Docparser to download a document from a publicly reachable URL and parse it with the given parser. Uses page credits of the account's plan (documents queue when credits run out). Docparser may buy extra credits by itself only if the account owner turned on automatic credit replenishment, or the account is on an annual plan that renews early when credits run out - check the Docparser billing settings first. This server never buys credits or changes the plan. Returns the new document_id: poll docparser_get_document_status, then read docparser_get_document_results. POST /v2/document/fetch/{parser_id}.
| Parameter | Type | Description |
|---|---|---|
| url * | string | Public http(s) URL of the file (PDF, image, Word, Excel, CSV, ...). |
| parser_id * | string | Docparser parser id (from docparser_list_parsers). |
| remote_id | string | Your own reference for the document (stored by Docparser; usable as a filter later). |
{
"name": "docparser_fetch_document_from_url",
"title": "Import a document from a URL",
"description": "WRITE: ask Docparser to download a document from a publicly reachable URL and parse it with the given parser. Uses page credits of the account's plan (documents queue when credits run out). Docparser may buy extra credits by itself only if the account owner turned on automatic credit replenishment, or the account is on an annual plan that renews early when credits run out - check the Docparser billing settings first. This server never buys credits or changes the plan. Returns the new document_id: poll docparser_get_document_status, then read docparser_get_document_results. POST /v2/document/fetch/{parser_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"parser_id",
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"minLength": 8,
"description": "Public http(s) URL of the file (PDF, image, Word, Excel, CSV, ...)."
},
"parser_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Docparser parser id (from docparser_list_parsers)."
},
"remote_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Your own reference for the document (stored by Docparser; usable as a filter later)."
}
}
},
"annotations": {
"title": "Import a document from a URL",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: upload one small file as base64 content to a parser and parse it. Uses page credits of the account's plan. Docparser may buy extra credits by itself only if the account owner turned on automatic credit replenishment, or the account is on an annual plan that renews early when credits run out - check the Docparser billing settings first. This server never buys credits or changes the plan. Files up to about 2.3 MB; use docparser_fetch_document_from_url for larger files. Returns the new document id and the remaining quota. POST /v1/document/upload/{parser_id}.
| Parameter | Type | Description |
|---|---|---|
| file_name | string | File name with extension (e.g. invoice.pdf); a time-based name is used if omitted. |
| parser_id * | string | Docparser parser id (from docparser_list_parsers). |
| remote_id | string | Your own reference for the document (stored by Docparser; usable as a filter later). |
| file_content * | string | The file, base64 encoded. |
{
"name": "docparser_upload_document",
"title": "Upload a document (base64)",
"description": "WRITE: upload one small file as base64 content to a parser and parse it. Uses page credits of the account's plan. Docparser may buy extra credits by itself only if the account owner turned on automatic credit replenishment, or the account is on an annual plan that renews early when credits run out - check the Docparser billing settings first. This server never buys credits or changes the plan. Files up to about 2.3 MB; use docparser_fetch_document_from_url for larger files. Returns the new document id and the remaining quota. POST /v1/document/upload/{parser_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"parser_id",
"file_content"
],
"properties": {
"file_name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "File name with extension (e.g. invoice.pdf); a time-based name is used if omitted."
},
"parser_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Docparser parser id (from docparser_list_parsers)."
},
"remote_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Your own reference for the document (stored by Docparser; usable as a filter later)."
},
"file_content": {
"type": "string",
"pattern": "^[A-Za-z0-9+/=_-]+$",
"maxLength": 3145728,
"minLength": 4,
"description": "The file, base64 encoded."
}
}
},
"annotations": {
"title": "Upload a document (base64)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: run the parser again over already imported documents (for example after changing parsing rules). Replaces their parsed data. Re-parsing documents already in the account does not use additional credits. 1-50 document ids per call. POST /v1/document/reparse/{parser_id}.
| Parameter | Type | Description |
|---|---|---|
| parser_id * | string | Docparser parser id (from docparser_list_parsers). |
| document_ids * | array | Ids of the documents to re-parse. |
{
"name": "docparser_reparse_documents",
"title": "Re-parse documents",
"description": "WRITE: run the parser again over already imported documents (for example after changing parsing rules). Replaces their parsed data. Re-parsing documents already in the account does not use additional credits. 1-50 document ids per call. POST /v1/document/reparse/{parser_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"parser_id",
"document_ids"
],
"properties": {
"parser_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Docparser parser id (from docparser_list_parsers)."
},
"document_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Docparser document id (the `id` / `document_id` of an uploaded document)."
},
"maxItems": 50,
"minItems": 1,
"description": "Ids of the documents to re-parse."
}
}
},
"annotations": {
"title": "Re-parse documents",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Tools for Docparser, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which document parsers do I have set up in my account?"; "Show the parsed results of the last 5 documents in my invoice parser."; "Has my last uploaded document finished processing yet?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Docparser data. Free plan: 50 tool calls per month. Run docparser_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run docparser_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run docparser_upgrade without a plan: it returns both plans, each with a payment link for the user to open. docparser_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.