How to Use the Fax.Plus MCP in Mastra AI

Q: How do I register Fax.Plus tools on this MCP Server in Mastra AI?

Install the integration package with npm install @mastra/mcp@latest in your project. Then, define a new MCPClient, call listTools(), and spread those tools directly into your agent's tool configuration.

Q: Can Mastra AI automatically retry a failed Fax.Plus transmission?

Yes, you can wrap the sendfax tool inside a Mastra workflow to handle failures. This setup allows you to define custom retry logic and fallback steps if a recipient's line is busy.

Q: Does Mastra AI support human approval before sending a Fax.Plus document?

You can enable the requireToolApproval flag on your agent to hold outgoing faxes. This pauses the workflow, requiring a manual sign-off before the agent executes the sendfax tool.

Q: How do I check my remaining balance before sending a document?

Use the getaccountinfo tool within your workflow to check your account status. Your agent can read these details to ensure you have enough credit before starting a large transmission.

Build resilient, self-healing fax workflows in TypeScript with the Mastra AI agent framework.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Fax.Plus MCP to Mastra AI

Create your Vinkius account to connect Fax.Plus to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Fax.Plus with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build resilient workflows with this MCP Server

The `send_fax` tool transmits digital documents to E.164 formatted numbers with optional custom comments. If a transmission fails due to a busy signal, Mastra's workflow engine can catch the error and retry automatically. You can configure exponential backoff rules directly in TypeScript to handle carrier hiccups. This prevents your agent from spamming the API while ensuring important documents actually reach their destination.

Monitor outbox queues with conditional branches

The `list_outbox_jobs` tool fetches all active and pending transmissions from your queue. Mastra agents can use this data to run conditional checks, routing stuck jobs to alternative pipelines. When a job remains pending too long, the workflow can trigger `cancel_outbox_job` and notify your team. This automation ensures your business operations don't grind to a halt over a single blocked line.

Audit your telephony inventory automatically

The `list_fax_numbers` tool retrieves all active numbers assigned to your business. Mastra can run scheduled cron jobs to compare this list against your database and flag unused lines. By combining this with `get_account_info`, the agent can verify if your current plan supports your active number count. Using this MCP Server keeps your communication overhead lean without requiring manual billing audits.

Setup guide

Set up Fax.Plus MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Fax.Plus tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "faxplus-mcp-client",
  servers: {
    "faxplus-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Fax.Plus Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Fax.Plus tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Fax.Plus transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Fax.Plus. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Fax.Plus now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Fax.Plus MCP in Mastra AI

Install the integration package with `npm install @mastra/mcp@latest` in your project. Then, define a `new MCPClient`, call `listTools()`, and spread those tools directly into your agent's tool configuration.

Yes, you can wrap the `send_fax` tool inside a Mastra workflow to handle failures. This setup allows you to define custom retry logic and fallback steps if a recipient's line is busy.

You can enable the `requireToolApproval` flag on your agent to hold outgoing faxes. This pauses the workflow, requiring a manual sign-off before the agent executes the `send_fax` tool.

Use the `get_account_info` tool within your workflow to check your account status. Your agent can read these details to ensure you have enough credit before starting a large transmission.

The server processes your account details and phone numbers inside an isolated V8 sandbox. No fax metadata is stored locally, and all transmissions use secure, direct API calls.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript