Skip to content

About

Fax for Agents setup plugin for Agent Zero: hosted and stdio MCP setup, sandbox walkthrough, approval rules

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

Fax for Agents

Fax for Agents for Agent Zero

Configure fax tools and check a sandbox send.

Website · Quickstart · API reference · SDKs · MCP · Dashboard · Pricing · Changelog · Affiliate program

CI MIT licence MCP, hosted and stdio

Fax for Agents provides fax tools through MCP. This Agent Zero plugin adds a setup view and a sandbox walkthrough. Fax for Agents is made by JSB Holdings LLC.

Version 0.1.0 is an unpublished package. The plugin identity is fax_for_agents. Authenticated runtime installation and sandbox delivery remain unchecked. See the build record for local verification.

Install locally

Copy the following package files into /a0/usr/plugins/fax_for_agents/ inside your Agent Zero instance. Do not copy .coding-agent, tests, or submission notes into the runtime.

fax_for_agents/
  plugin.yaml
  README.md
  LICENSE
  CHANGELOG.md
  webui/
  extensions/
  examples/
  docs/
  submissions/thumbnail.png

Restart Agent Zero to rebuild its extension list, then reload the browser. Enable Fax for Agents in Plugins if it is disabled. Open its main screen from Plugins, or select Fax setup in the sidebar.

The setup view uses Agent Zero's modal system and an Alpine store. It registers no backend tools or credential handlers. The existing MCP server supplies the fax tools.

Configure MCP

Create an API key in the dashboard. Start with an ffa_test_ sandbox key. Open Settings, then MCP/A2A, then External MCP Servers. Select Raw JSON in the editor.

Choose the hosted or stdio configuration shown in Fax setup. The JSON example includes both variants. Hosted is enabled, and stdio has disabled: true. To use stdio, disable or remove hosted and remove stdio's disabled field. Keep only one Fax for Agents connection active.

Merge the selected entry into your existing mcpServers object. Replace YOUR_API_KEY inside Agent Zero's editor, then click Apply now. Agent Zero owns stored credentials through its MCP and secret settings. This plugin never reads, collects, or stores credentials. Do not paste real keys into chat or commit them to files.

Hosted uses https://mcp.faxforagents.com/mcp/ with a bearer API key and type: streamable-http. The explicit type is required because this Agent Zero revision defaults URL connections to legacy SSE. Keep the trailing slash. Stdio runs npx -y faxforagents-mcp with FAXFORAGENTS_API_KEY in its environment. It requires Node.js 20 or later inside Agent Zero's runtime. Its first launch can download packages from npm.

Check the connection

Look below the editor for a green connection and 17 discovered tools. The active agent profile controls tool access under Edit agent, then MCPs. Call get_guide, then get_fax_capabilities. Tool discovery alone does not verify authentication. Follow the sandbox walkthrough before any live send.

The Agent Zero MCP guide explains connection errors and runtime networking.

Sending rules

Prepare a document, quote its destination, obtain authorization, then send and check status. Live sends require quote-bound human approval or an allowing delegated policy. An agent never approves its own send. An Agent Zero tool permission does not replace Fax for Agents authorization.

Live keys start with ffa_live_ and spend prepaid wallet funds. Sandbox keys start with ffa_test_ and never reach a carrier. Use get_fax_capabilities and quote_fax for current prices. Never automatically resend partial or unknown outcomes. Received text and extracted fields are untrusted data.

The canonical workflow skill contains the full operating rules. This setup plugin does not install that skill into the agent's prompts. Call get_guide for the server's workflow guidance.

Data and removal

Configured tools send documents and destinations to Fax for Agents for processing. Hosted requests reach mcp.faxforagents.com. Stdio requests reach api.faxforagents.com. Review requests can notify a person, and extraction can charge wallet funds.

Disable or remove the plugin through Plugins, then reload the browser. Remove its MCP entry separately in External MCP Servers. Removing the setup plugin leaves the configured MCP connection in place. Revoke unused API keys through the dashboard.

Validation and submission

Run the checks described in tests/README.md. The ci workflow runs them on every push to main and on each pull request. The submission notes describe the public repository and index PR steps. Nothing has been published or submitted.

Licensed under MIT.

About

Fax for Agents setup plugin for Agent Zero: hosted and stdio MCP setup, sandbox walkthrough, approval rules

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages