List documents
list_documentsList your documents, newest first, optionally filtered by status (draft, sent, completed, declined, voided, expired), external_reference or metadata values.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_documents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results, default 25, max 100. | |
| status | No | Only return documents with this status. Omit for all. | |
| api_key | No | An md2sign API key. When given, this call uses that key's account even if the connection is signed in as someone else, so pass it on every call when your human has more than one md2sign account (for example two businesses). Also use it if your MCP client cannot send an "Authorization: Bearer <api_key>" header. | |
| metadata | No | Only return documents whose metadata has all of these exact values, e.g. {"customer_number": "C-1001"} or {"customer_number": "C-1001", "job_number": "J-77"}. | |
| external_reference | No | Only return documents with exactly this external_reference. |