# Telnyx Fax MCP for AI Agents AI Agent Connect

> Telnyx Fax lets you send, receive, and manage faxes through your AI agent. You can transmit PDF and TIFF documents to any fax number worldwide, track their delivery status in real time, and manage your fax-enabled phone numbers. It's the standard way to bring reliable faxing into your automated workflows without touching a traditional fax machine.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_6C2KtQn3A7nLeAy9k7Ksa6kRLQXm0mhUudyAtRUL/ai-agent-connect
- **Tags:** digital-fax, fax-api, document-transmission, delivery-tracking, telecom-infrastructure

## Description

This Connector connects your Telnyx account directly to your AI workflow, letting you handle document transmission through a simple conversation. Imagine you're in a situation where you need to get a legal document or a medical record to a provider who still relies on traditional faxing. Instead of logging into a legacy portal, uploading a file, and then refreshing a browser to see if it actually went through, you just tell your AI agent to do it. You can send files like PDFs or TIFFs to any number on the planet, and the agent can tell you exactly when they arrive. If a transmission gets stuck or needs to be stopped, you just ask the agent to handle it. It takes the manual headache out of managing fax numbers and application settings, turning a clunky, old-school process into a modern automated task. Because Vinkius hosts this among thousands of other tools, you can plug it into your existing setup and start moving documents instantly. It's about getting the job done without the friction of old technology.

## Tools

### get_fax_number
Get the details and status of a specific fax-enabled phone number. This helps you identify active numbers in your account.

### list_fax_applications
See a list of all fax applications currently in your account. This is great for managing multiple configurations.

### list_faxes
View a complete history of all sent and received faxes. Use this to audit your recent document activity.

### list_media
See all the documents and files you've uploaded for faxing. This makes it easy to find the right file for a new transmission.

### list_fax_numbers
Find all the phone numbers in your account that are enabled for faxing. This helps you manage your telecom inventory.

### send_fax
Send a document to a recipient number using a specific connection ID and media URL. This is the primary tool for sending faxes.

### check_telnyx_status
Verify that your connection to the Telnyx API is active and working. This ensures your agent can reach the faxing service.

### get_fax_application
Pull the specific details and configuration for your fax application. It is useful for checking your current settings.

### get_fax
Retrieve specific information about a single fax transmission. Use this to see the details of a specific sent document.

### cancel_fax
Stop a fax transmission that is currently in the queue. Use this to prevent errors or duplicate sends.

## Prompt Examples

**Prompt:** 
```
Send the invoice.pdf to +1-555-0199.
```

**Response:** 
```
I've submitted the invoice to +1-555-0199. The transmission is currently in progress. Would you like me to check the delivery status for you in a few minutes?
```

**Prompt:** 
```
What's the status of my faxes today?
```

**Response:** 
```
You've sent 5 faxes today. Here is the summary:

| Status | Recipient | Pages |
|---|---|---|
| Delivered | +1-555-0100 | 3 |
| Delivered | +1-555-0200 | 2 |
| In Progress | +1-555-0199 | 4 |
| Pending | +1-555-0300 | 1 |
| Failed | +1-555-0400 | 5 |
```

**Prompt:** 
```
Show me all the fax numbers I have.
```

**Response:** 
```
You have 3 active fax-enabled numbers in your account:

* +1-555-0100 (US)
* +44-20-7946-0958 (UK)
* +1-555-0200 (US Toll-Free)

All numbers are currently active and ready to send or receive faxes.
```

## Capabilities

### Send faxes to any worldwide number
Transmit PDF and TIFF documents to any fax number on the planet.

### Track real-time delivery status
Get confirmation on whether your documents actually reached the recipient.

### List all sent and received faxes
View a complete history of your fax activity in one place.

### Manage fax-enabled phone numbers
View and organize all numbers in your account that are ready for faxing.

### Cancel queued fax transmissions
Stop a fax from sending if you realize it was sent to the wrong person.

### Access uploaded media files
See all the documents you have stored and ready for transmission.

### Configure fax application settings
Update your webhook URLs and other application details through your agent.

## Use Cases

### Medical Record Sharing
A clinic needs to send a patient's history to a specialist. The admin tells the agent to send the PDF to the specialist's fax number.

### Legal Document Filing
A law firm sends out dozens of discovery documents daily. They use the agent to batch-send files and check statuses in real time.

### Automated Alerts
A developer sets up a system where a failed payment triggers an automated fax notification to a merchant's office.

### Bulk Number Management
An operations lead needs to audit all fax numbers. They ask the agent to list all active numbers and check their statuses.

## Benefits

- Stop manual portal logins by using send_fax to transmit documents directly from your chat interface.
- Get instant confirmation of delivery using list_faxes to see what actually reached the recipient.
- Manage your entire fleet of numbers easily with list_fax_numbers and get_fax_number for better organization.
- Keep your workflow moving by using cancel_fax to stop transmissions that no longer need to go out.
- Centralize your files by using list_media to see every document ready for sending in one place.
- Automate your setup by using list_fax_applications and get_fax_application to manage webhook URLs and settings.

## How It Works

The bottom line is you turn your AI agent into a fully functional fax machine that handles the heavy lifting of document delivery.

1. Subscribe to this Connector and grab your API Key from the Telnyx Mission Control portal.
2. Connect the Connector to your preferred AI client like Claude, Cursor, or Windsurf.
3. Start sending faxes or checking statuses using natural language prompts.

## Frequently Asked Questions

**Can I send PDFs through the Telnyx Fax MCP?**
Yes, you can send PDF and TIFF documents to any fax number worldwide. The agent handles the transmission and gives you a confirmation once the file is queued.

**How do I know if my fax actually arrived?**
You can ask your agent to check the status of your faxes. It will look at your recent history and tell you if a document was successfully delivered or if it's still pending.

**Can I manage my fax numbers with this Connector?**
Yes, you can use the agent to list all your fax-enabled numbers, view their specific details, and see which ones are active in your Telnyx account.

**Is this good for healthcare compliance?**
Yes, it's built for industries like healthcare and legal where secure faxing is a requirement. It lets you move records through your AI workflow while maintaining those standards.

**Can I stop a fax that is already sending?**
Yes, if you realize a document was sent to the wrong number or contains an error, you can ask the agent to cancel the queued transmission immediately.

**How do I get my Telnyx API key for this?**
You can find your API key in the Telnyx Mission Control portal. Once you have it, you can plug it into your AI client to start using the fax tools.

**How do I send a fax via AI?**
Use the `send_fax` tool with your connection ID, recipient phone number (E.164 format), and a URL to the PDF or TIFF document.

**Can I check the status of a sent fax?**
Yes. Use `get_fax` with the fax ID to see delivery status, page count, duration, and any error details.

**How do I see my fax-enabled phone numbers?**
Use `list_fax_numbers` to retrieve all phone numbers in your Telnyx account that have fax capability enabled.