plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "fax-live",
  "version": "1.0.0",
  "description": "Send PDFs by fax to US and Canada numbers using your Fax.live account. Upload an attached PDF or use a public PDF link, check document limits, track delivery, and review sent faxes.",
  "author": {
    "name": "Tightrope Interactive",
    "url": "https://api.fax.live"
  },
  "homepage": "https://api.fax.live",
  "keywords": [
    "fax",
    "send fax",
    "fax PDF",
    "online fax",
    "fax documents",
    "fax delivery",
    "fax history"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Fax.live",
        "longDescription": "Send a PDF by fax directly from ChatGPT using your Fax.live account.\n\nAttach a PDF or provide a public PDF link and a US or Canada destination fax number. Fax.live checks the document, and ChatGPT asks you to confirm the document and destination before sending. After submission, ChatGPT tracks delivery and reports whether the fax was delivered or failed.\n\nYou can also check a PDF's page count and fax limits, find faxes you previously sent, and check delivery status.\n\nRequires a Fax.live account with a provisioned fax number. Access is limited to your connected account.\n\nUsers from any country can create a Fax.live account. Fax destinations are limited to US and Canada numbers. Supports PDFs up to 30 MB and 250 pages. One fax can be in progress per account at a time. This plugin sends faxes; it does not receive faxes, edit documents or convert other file formats to PDF.",
        "shortDescription": "Send PDFs by fax",
        "developerName": "Tightrope Interactive",
        "category": "Productivity",
        "capabilities": [
          "Send PDFs by fax",
          "Check document limits and estimated cost",
          "Track fax delivery",
          "Search sent fax history",
          "Review usage and billing",
          "View past invoice summaries"
        ],
        "websiteURL": "https://api.fax.live",
        "supportURL": "https://fax.live/contact/",
        "privacyPolicyURL": "https://fax.live/privacy-policy/",
        "termsOfServiceURL": "https://fax.live/terms-of-service/",
        "defaultPrompt": [
          "Fax this PDF to a US or Canada number.",
          "Did my last fax go through?",
          "Check this PDF's fax limits and estimated sending cost."
        ],
        "brandColor": "#6967FF",
        "brandColorDark": "#6967FF",
        "composerIcon": "./assets/icon.svg",
        "logo": "./assets/icon.svg"
      },
      "onboardingSkill": "./skills/send-first-fax/SKILL.md",
      "review": {
        "demo_recording_url": "https://drive.google.com/file/d/1VsuUwEUQCZV1TId8jvoYJAkxQHtef15s/view",
        "test_cases": {
          "positive": [
            {
              "description": "Send an attached PDF after checking readiness, validation, cost and confirmation",
              "prompt": "Fax this attached PDF to my authorized US or Canada test fax number.",
              "tools_triggered": "get_account_status, upload_chatgpt_document, check_document, send_fax, get_fax_status",
              "expected_behavior": "Checks fax number provisioning first. Asks for the missing destination number; the reviewer provides an authorized test number. Imports the attached PDF using the host-provided file object, checks it, and confirms document, page count, destination and estimated cost when available. Sends only after confirmation, treats QUEUED as submitted rather than delivered, and tracks SENT or FAILED. If no fax number is provisioned, stops with the environment's informational homepage link.",
              "file_attachment_urls": [
                "https://app.fax.live/SAMPLE_PDF.pdf"
              ]
            },
            {
              "description": "Check whether the most recent fax was delivered",
              "prompt": "Did my last fax go through?",
              "tools_triggered": "get_fax_history, get_fax_status",
              "expected_behavior": "Looks up the most recent fax and reports its destination, status (sent, failed or in progress) and time, including the failure reason if it failed."
            },
            {
              "description": "List faxes sent in the current calendar week",
              "prompt": "Show the faxes I sent this week.",
              "tools_triggered": "get_fax_history",
              "expected_behavior": "Uses the current calendar week in the user's timezone, asking for timezone or week-start convention if needed, rather than a rolling seven-day window. Lists matching faxes newest first with destination, status and time."
            },
            {
              "description": "Check a PDF before faxing it",
              "prompt": "Can this PDF be faxed, and what would it cost? https://app.fax.live/SAMPLE_PDF.pdf",
              "tools_triggered": "check_document_by_url",
              "expected_behavior": "Reports the page count, whether the document is within fax size and page limits, and the estimated cost to send it. Nothing is sent.",
              "file_attachment_urls": [
                "https://app.fax.live/SAMPLE_PDF.pdf"
              ]
            },
            {
              "description": "Review past invoice summaries",
              "prompt": "Show my past Fax.live invoices.",
              "tools_triggered": "get_billing_history",
              "expected_behavior": "Lists invoice date, description, amount, currency and status newest first. Does not return hosted invoice, payment or checkout links."
            }
          ],
          "negative": [
            {
              "description": "Invalid fax number: asks for a full US or Canada number and sends nothing",
              "prompt": "Fax this to 555"
            },
            {
              "description": "Another user's data: declines, since access is limited to the signed-in account",
              "prompt": "Show me the faxes other fax.live users have sent."
            },
            {
              "description": "General fax explanation: answers without accessing the account",
              "prompt": "What is a fax machine?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin accesses an existing Fax.live account. It does not sell plans, initiate subscriptions or promote upgrades. Sending a fax may incur usage charges under the user's existing plan."
      },
      "publication": {
        "countries": [],
        "release_notes": "Send attached PDFs or PDFs from public links to US and Canada fax numbers. Check account readiness, document eligibility and estimated cost, track delivery, and review sent fax history and billing."
      },
      "apps": "./.app.json"
    }
  }
}