# Documo MCP

> Documo connects your AI agent to digital fax management, letting you audit transmissions and track numbers instantly. It gives you total visibility into inbound/outbound faxes, failure reports, and user access logs without logging into a separate portal.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** digital-fax, secure-transmission, document-workflow, fax-automation, transmission-logs

## Description

Sending important documents by fax used to mean paper trays, messy filing cabinets, and praying the machine actually connected. Documo changes that. This MCP lets your agent handle all things digital fax—from checking if a document got delivered to listing every fax number you own. You can ask it to pull up delivery receipts for old transmissions or run a quick audit on usage limits. It's like having an IT admin dedicated solely to your faxes, available 24/7. When you connect this MCP via Vinkius, your AI client gains the power to monitor real-time logs, list who uses which line, and even pinpoint why a fax transmission failed. You just talk to your agent, and it runs the diagnostics for you.

## Tools

### get_documo_account_metadata
Retrieves your account's operational metadata and current usage thresholds.

### get_fax_details
Pulls specific information, including the status, for one particular fax transmission.

### quick_fax_volume_audit
Provides an immediate, high-level summary of total fax transmissions and overall success rates.

### list_failed_fax_deliveries
Identifies and lists specific faxes that did not transmit correctly, noting the failure reason.

### list_assigned_fax_numbers
Provides a list of every unique fax number currently assigned to your company account.

### list_digital_faxes
Generates a comprehensive list of all digital faxes that have passed through the system.

### list_received_digital_faxes
Gathers a complete record of all digital faxes that have been successfully received by your organization.

### list_latest_fax_transmissions
Presents a list of the most recent fax activity, both sent and received.

### list_documo_users
Retrieves a directory listing of every user registered within your organization's Documo account.

### search_faxes_by_recipient
Filters the entire archive to find faxes specifically matching a given recipient phone number or identifier.

## Prompt Examples

**Prompt:** 
```
List the most recently sent faxes.
```

**Response:** 
```
I've found 5 recent transmissions, including faxes to '+1 (555) 0123' and '+1 (555) 9876'. All were successfully delivered. Would you like to see the page count for any of these?
```

**Prompt:** 
```
Show me all fax numbers assigned to our account.
```

**Response:** 
```
Your account has 3 active fax numbers: '+1 (555) 1111' (Main Office), '+1 (555) 2222' (HR), and '+1 (555) 3333' (Support). Should I check the inbound fax volume for any of these lines?
```

**Prompt:** 
```
Check the status of fax 'FAX-9988'.
```

**Response:** 
```
Fax 'FAX-9988' sent to '+1 (555) 4444' is currently 'Delivered'. It was 4 pages long and transmitted via the 'Main Office' line. Should I pull the delivery receipt?
```

## Capabilities

### Audit Account Usage
Check account metadata and usage limits to know if you're running into capacity issues.

### View All Digital Faxes
List every fax your organization has sent or received, along with its delivery status.

### Check Transmission Status
Get detailed information and current status for a single fax transmission using an ID or reference number.

### Audit Assigned Fax Lines
List all active and assigned phone numbers used for faxing within your organization's account.

### Identify Failed Deliveries
Find records of faxes that failed to transmit correctly, including the reason for failure.

### Monitor Recent Activity
See the most recently sent or received faxes and their key details immediately.

### Search by Recipient
Filter through your history to find specific transmissions based on a recipient's phone number.

## Use Cases

### The Compliance Review
A legal admin needs proof of all faxes sent last quarter. They ask their agent to run `list_digital_faxes` and filter by date range, instantly generating an audit-ready list showing both success status and recipient details.

### The Missing Document
An operations manager can't find the fax sent last week. They use `search_faxes_by_recipient` with the client's number, quickly pulling up the exact transmission record and confirming its delivery status.

### The Capacity Check
An IT admin suspects the system is throttling transmissions. By calling `get_documo_account_metadata`, they check the current usage against the service limits, preventing a costly operational outage.

### Investigating an Error
A team member gets a complaint that a fax failed. They use `list_failed_fax_deliveries` to retrieve the error log and confirm if the failure was on their end or the recipient's.

## Benefits

- Never worry about lost documents again. Instead of checking multiple tabs, using `list_latest_fax_transmissions` gives you a single view of all recent activity.
- Stop guessing why things fail. If a document didn't make it through, running the `list_failed_fax_deliveries` tool tells you exactly what went wrong and why.
- Keep your compliance airtight. Use `quick_fax_volume_audit` to get an immediate snapshot of success rates and overall transmission volume for reporting.
- Need to know who has access? Running `list_documo_users` gives administrators a full roster of all accounts, helping with internal audits instantly.
- Targeting specific files is easy. Instead of scrolling through thousands of entries, use `search_faxes_by_recipient` to pull up only the documents for that one client.
- Know your limits upfront. Use `get_documo_account_metadata` to check usage caps and ensure you don't hit a service limit mid-workflow.

## How It Works

The bottom line is, you run complex fax audits just by asking your AI client simple questions.

1. Connect this MCP to your AI client and authorize it using your Documo API Key.
2. Ask your agent to perform an action, like 'Show me all faxes that failed last week,' or 'List the numbers we use in HR.'
3. Your agent calls the necessary tool, pulls the data from Documo, and gives you a plain language summary of the results.

## Frequently Asked Questions

**How do I check if a fax was successful using `get_fax_details`?**
The agent will pull the status for you. It provides specific details, telling you if it's 'Delivered,' 'Failed,' or 'Pending,' along with supporting data like page count.

**Can I find all my company's fax numbers using `list_assigned_fax_numbers`?**
Yes, running this tool returns every unique fax number currently assigned to your Documo account. This is useful for auditing and ensuring coverage.

**What if I need to check old faxes? Does `list_digital_faxes` cover them?**
It lists all digital faxes in the system. If you want a specific one, use `search_faxes_by_recipient` and enter the recipient's phone number for filtering.

**Do I need to worry about capacity with `quick_fax_volume_audit`?**
This tool gives you a high-level summary of success rates and total transmissions. It helps flag unusual dips or spikes in volume that might require checking your metadata.

**What do I use if a fax fails to send? Can `list_failed_fax_deliveries` help me track errors?**
Yes, it gathers records of all transmissions that didn't go through. You get the failure reason and original data, helping you know exactly why delivery failed.

**How do I check my account usage or limits? Should I use `get_documo_account_metadata`?**
This function retrieves key metadata about your entire Documo setup. You see current usage counts, allocated quotas, and any service limits right away.

**I need to audit my team's access. What does `list_documo_users` give me?**
It provides a roster of every user registered within your organization. This lets you review profile details and check permissions, which is key for compliance audits.

**If I only know the recipient's phone number, can `search_faxes_by_recipient` find the fax?**
Yes, this tool searches all transmissions based on a specific phone number or identifier. It pulls up records even if you don't have the original transmission ID.

**How do I get a Documo (mFax) API Key?**
Log in to your Documo/mFax portal, navigate to **Settings > API**, and you can generate or retrieve your unique API Key from there. Ensure you have the necessary plan permissions.

**Can the agent send new faxes?**
This integration currently focuses on listing and auditing faxes, numbers, and users. Sending new faxes with attachments should be managed via the Documo web portal or print driver.

**Does it support HIPAA compliant faxing?**
Documo/mFax is built for security and compliance (including HIPAA). This integration uses official API protocols to access your secure transmission data.