# Connect with OAuth

> Connect your AI client to Fax for Agents. Review permissions, choose Sandbox or Live, and revoke access from Connected apps.

Page: https://faxforagents.com/docs/mcp/
Last changed: 2026-11-04

Updated Nov 4, 2026

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](https://faxforagents.com/docs/mcp-setup/).

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.

## 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](https://app.faxforagents.com/app/settings) 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](https://faxforagents.com/docs/sandbox/) and [approval rules](https://faxforagents.com/docs/approvals/). For help with a connection, email [hello@faxforagents.com](mailto:hello@faxforagents.com).