DocDocDoc MCP Server
A Model Context Protocol server for the DocDocDoc API that enables document request management.
Overview
DocDocDoc is a document request service that allows users to request documents from others. The requested person receives a notification and can upload the required documents through a secure access link.
Features
- Request Management: Create, read, update, delete, and cancel document requests
- Status Tracking: Monitor request lifecycle
- Document Types: Support for specific document types (ID cards, passports, etc.)
- API Integration: Full integration with DocDocDoc staging API
Available Tools
Request Operations
create_request- Create a new document requestget_request- Get request details by IDupdate_request- Update request informationdelete_request- Delete a request permanentlycancel_request- Cancel a request (sets status to cancelled)
Data Models
Request Statuses
pending- Request created, waiting for responseviewed- Request has been viewed by the requested personcancelled- Request was cancelledcompleted- Request fulfilled with documentsrejected- Request was rejectedapproved- Request was approvedexpired- Request has expired
Document Types
id_card- National ID cardpassport- Passportdriver_license- Driver's licenseresidence_permit- Residence permitstatutes- Company statutescompany_registration- Company registration documentsbeneficials_owner_register- Beneficial owners register
Installation
uv sync
Usage
Run the server:
uv run main.py
The server will start on HTTP port 3000 by default.
Configuration
HTTP Transport (Recommended)
Add to your MCP configuration:
{
"mcpServers": {
"docdocdoc-mcp-server": {
"url": "http://localhost:3000",
"env": {
"API_KEY": "your-api-key-here",
"BASE_URL": "https://staging.docdocdoc.fr"
}
}
}
}
Legacy STDIO Transport (Deprecated)
⚠️ Note: STDIO transport will be discontinued on September 7th, 2025. Please migrate to HTTP transport.
{
"mcpServers": {
"docdocdoc-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/path/to/docdocdoc-mcp-server",
"run",
"main.py"
],
"env": {
"API_KEY": "your-api-key-here",
"BASE_URL": "https://staging.docdocdoc.fr"
}
}
}
}
Environment Variables
API_KEY- Your DocDocDoc API key (required)BASE_URL- API base URL (defaults to https://staging.docdocdoc.fr)
Example Usage
1. Create a Document Request
create_request(
requested_email="john.doe@company.com",
requested_name="John Doe",
requestor_email="hr@company.com",
requestor_name="HR Department",
document_type="id_card",
message="Please provide your ID card for verification"
)
2. Get Request Details
get_request(request_id="123e4567-e89b-12d3-a456-426614174000")
3. Update a Request
update_request(
request_id="123e4567-e89b-12d3-a456-426614174000",
message="Updated: Please provide your passport instead",
document_type="passport"
)
4. Cancel a Request
cancel_request(request_id="123e4567-e89b-12d3-a456-426614174000")
5. Delete a Request
delete_request(request_id="123e4567-e89b-12d3-a456-426614174000")
Security Features
- API key authentication via
X-API-Keyheader - Input validation for emails, phone numbers, and required fields
- Proper error handling and validation
Architecture
- Modular Design: Clean separation of concerns with dedicated modules
- API Client: Centralized HTTP client for DocDocDoc API
- Configuration: Environment-based configuration management
- Error Handling: Comprehensive validation and error reporting
Notes
- All operations work with live API endpoints
- Supports full CRUD operations for document requests
- Request cancellation preserves data while marking as cancelled
- Request deletion permanently removes data from the system