Connect with OAuth

Updated

Connect your AI client to https://mcp.faxforagents.com/mcp to prepare, quote and send faxes.

The hosted server uses Streamable HTTP. Existing API keys and local stdio clients keep working.

Connect with OAuth

OAuth sign-in is being rolled out. If your client does not offer sign-in yet, use the API key setup instructions.

In your client's custom connector settings, paste https://mcp.faxforagents.com/mcp. Start a tool that reads your account, such as get_fax_balance.

When sign-in is available, your client opens Fax for Agents. Sign in to your dashboard account to review the connection.

The consent screen shows the app's hostname and name, its return address and the permissions it requests. Check the hostname before allowing access.

Choose your organization and environment. Sandbox is selected by default. Sandbox faxes stay inside the test service and do not reach a recipient.

Live means real faxes and real charges. It requires a recent sign-in. Sending still needs an approval or a policy that allows it.

Your role limits the permissions you can grant. A viewer cannot grant permission to send faxes. Connected apps cannot create API keys or change billing.

Choose Allow to return to your client, or Deny to cancel. If the screen says an app runs on your computer, confirm you started it.

Disconnect an app

Open Settings in the dashboard and find Connected apps. Check the organization and environment, then choose Revoke.

Type the app's hostname when asked. Revocation stops that connection's tokens from working. To reconnect, start sign-in again from your client.

Disconnecting an app does not cancel a fax already queued. Check the fax's state before deciding what to do next.

Check the connection

Call get_fax_capabilities to check your environment and permissions. The public get_guide tool explains the send steps without signing in.

get_fax_document replaces get_document, with no alias. Refresh cached tool lists before inspecting document pages.

Use get_review_status for a human approval decision. Use get_fax_status for outbound delivery after sending.

list_faxes lists outbound faxes. list_inbox lists received items. Read one received item with read_inbound_fax.

A send first returns queued. Read get_fax_status for the outcome and the provider's evidence.

See sandbox outcomes and approval rules. For help with a connection, email hello@faxforagents.com.