Skip to main content
This guide is a worked example for an AI assistant that can make HTTP requests: a coding agent such as Claude Code, Codex, or Cursor. An AI chat app with the PayPerFax connector uses the same request over MCP. Not a developer? Read Can ChatGPT or Claude send a fax for me? The person has a signed IRS form (for example Form 2848, Power of Attorney) and needs to fax it to the IRS. The assistant prepares the fax; the person adds the signed form on the web form and pays. The main-site page for this case is payperfax.com/send-fax-to/fax-irs/. The service is described on payperfax.com/pay-per-fax-api/.

Who does what

Before you start

1

Get the fax number from irs.gov

IRS fax numbers depend on the form and the person’s state. Find the number for the form on irs.gov, on the form’s own instructions page. Show the source to the person before you prepare the fax.Do not guess the number, and do not use one from a third-party directory. The person’s own IRS notice is also a valid source.
2

Ask for the person's email

The confirmation and the receipt go there. Ask the person for the address. Do not guess it.
3

Do not retype the signed form

The signed form is a file. Do not retype it as text: a typed copy of a signed form is not the form.

Prepare the fax

The person has the signed form on their own device, and you do not have the file. So you send the create request with file_expected=true. The response is a link to the web form, with the fax number already filled in. The person adds the file there.
The number above is an example. Use the number from irs.gov for the form the person is sending.
The response is 200 with only url:
Give url to the person. The link opens the web form with the IRS fax number filled in and the notice “Your AI assistant prepared this fax”. The person uploads the signed form, checks the preview with the price, and pays. The link expires after 24 hours. The form shows prices in the currency of the person’s own browser location, so country has no effect on a form link.

If you also wrote a cover letter

If the person needs a short cover letter (for example “Attached: Form 2848 for tax year 2025, signed 2026-04-15, from Jane Doe”), write it as Markdown and send it in the same request. The letter becomes letter.md, the first document of the fax; the signed form that the person adds on the web form goes after it.
A fax has no cover page unless you request one, so the letter must include its own names, date, and address block at the top. Do not put a full Social Security number in a letter you write; the signed form already identifies the taxpayer.

The same request over MCP

If the AI app has the PayPerFax MCP server connected, the same request is the tool create_fax, with the same fields. Set to to the IRS fax number for the form, email to the person’s address, file_expected to true for a signed form, and markdown for the cover letter. The result is the same form url. MCP has no file transfer, so the person always adds a signed form on the web form.

After the person pays

A form link has no id, so you cannot read the status until the person gives you the address. After payment, the person’s confirmation page shows Track this fax with your AI assistant, with a prompt like this:
Ask the person to copy that prompt to you. Then read the status address (with get_fax_status over MCP, or a GET request over HTTP). Over HTTP, read every 15 seconds while the fax is sending, and stop when is_terminal is true. In a chat, read it when the person asks. See Check the status for the fields and the polling rules. The person also gets the result by email. The person is not charged if the fax is not delivered.

What to tell the person

  • The link opens the web form. You add the signed form there.
  • Nothing is sent and nothing is charged before you pay.
  • A failed fax is not charged. If the IRS line is busy, you can send it again with the resubmit link on the confirmation page.
  • The link expires after 24 hours.
  • After you pay, copy the tracking prompt from the confirmation page to me if you want me to follow the fax.

Send a fax

The create request reference

Check the status

Status values and polling

Page for AI assistants

The rules in plain language

Fax the IRS

Main-site page for faxing the IRS