MCP Connector

Use RevExOS Tools Inside Claude, ChatGPT and Codex

RevExOS runs a free Model Context Protocol (MCP) server, so you can parse invoices and purchase orders, draft AR collections emails and run Q2C calculators without leaving Claude, ChatGPT or Codex. For invoice files on your own computer, there is also a Claude skill.

Connector URL

https://revexos.com/api/mcp

Setup

1

In Claude: open the connector settings

In claude.ai or the Claude desktop app, go to Settings → Connectors → Add custom connector. Name it RevExOS.

2

Paste the connector URL

Enter https://revexos.com/api/mcp as the server URL and click Add. There is no sign-in: if Claude says it couldn't determine how the server signs in, click Continue anyway, then Connect.

3

Ask Claude to draft a collections email

e.g. "Draft a firm collections email for invoice INV-1042, $4,500, due Sep 1, now 20 days overdue." Claude calls the tool and returns a ready-to-send subject and body.

4

Or parse an invoice from a link

e.g. "Parse the invoice at https://example.com/inv-4471.pdf and check the totals. My email is you@company.com." The link must download the file without a login.

Setup in ChatGPT and Codex

ChatGPT

Open Plugins, click +, then Add custom MCP server. Name it RevExOS, enter https://revexos.com/api/mcp, choose No authentication, accept the warning and create it as a plugin. Install it from your plugins with +, start a new chat and type @RevExOS. You can attach invoice and PO files straight to the chat; ChatGPT passes them to the tools, so no public link is needed.

Codex

Run codex plugin marketplace add prab-hub/revexos-q2c-kit, then /plugins in Codex, install revexos-q2c-kit and start a new session. This adds the Q2C skills and this MCP server together.

What's available today

  • parse_invoice: give it a public link to an invoice PDF or image (or, in ChatGPT, attach the file) and get back the header fields, every line item, and a check that the totals add up. Same engine as the Invoice Parser. The file is not stored.
  • parse_purchase_order and match_po_to_invoice: read a purchase order, or compare it with the invoice billed against it line by line, the same checks as the three-way match checker.
  • generate_ar_collection_email: the same logic behind the AR Collections Email Generator.
  • Calculators: calculate_proration, build_revrec_schedule, calculate_late_payment_interest and calculate_invoice_due_date run the same code as the proration, revenue recognition, late payment interest and due date calculators, so the numbers match the site.

The document tools and the email generator need an email address (document tools: 5 uses per email per day). RevExOS uses it only to send occasional updates about new free AP/AR tools, never spam. The calculators need nothing.

Install the RevExOS Q2C Kit

Free, open-source quote-to-cash skills for Claude and Codex: quotes, contract handoff, PO to invoice, three-way match, billing and proration, payment terms and late fees, collections and revenue recognition, billing platform selection, and invoice parsing. Installing it also adds this connector and the commands /quote, /parse-invoice, /dunning, /prorate and /revrec-schedule.

claude.ai, Claude Desktop or Cowork: Customize → Plugins → Add → Add marketplace → Add from a repository, enter prab-hub/revexos-q2c-kit and click Sync. Then open the Discover tab, search RevExOS and install RevExOS Q2C Kit (adding the marketplace alone installs nothing).

Codex: run codex plugin marketplace add prab-hub/revexos-q2c-kit, then install it from /plugins.

Claude Code: run /plugin marketplace add prab-hub/revexos-q2c-kit, then /plugin install revexos-q2c-kit@revexos-q2c-kit. Everything in the kit is on the Q2C Kit page.

Parse invoice files with the Claude skill

In Claude, the connector needs a public link. To parse a file you uploaded to Claude or have on disk, install the RevExOS Invoice Parser skill (free, open source). It returns the same fields and totals checks, and can save CSV or JSON.

1

claude.ai, Claude Desktop or Cowork

Go to Customize → Plugins → Add → Add marketplace → Add from a repository, enter prab-hub/revexos-invoice-parser and click Sync. Adding the marketplace does not install anything yet: open the Discover tab, search RevExOS and install RevExOS Invoice Parser. This adds the skill and the connector above.

2

Claude Code

Run /plugin marketplace add prab-hub/revexos-invoice-parser, then /plugin install revexos-invoice-parser@revexos-invoice-parser.

3

Allow network access to revexos.com

The skill sends the file to revexos.com from Claude's code sandbox. In Settings → Capabilities, add revexos.com to the allowed domains for code execution (or allow all domains). On Team and Enterprise plans an org owner may need to change this in the admin settings.

Limits: 2 parses a day per network, 5 with an email. Files up to 3MB. The file is not stored.

Troubleshooting

"405" or "Not found" when adding the connector
Check the URL is exactly https://revexos.com/api/mcp.
"Couldn't determine how this server signs in"
Expected: the server needs no sign-in. Click Continue anyway, then Connect.
Skill fails with "Tunnel connection failed: 403 Forbidden" or "connect_rejected"
Your network policy for code execution is blocking revexos.com. Add it to the allowed domains (step 3 above). Retrying without that won't help.
Added the marketplace in Claude, but the plugin is not under Yours
Adding a marketplace only makes its plugins available. Open the Discover tab, search RevExOS and click install. To pick up a newer version, use Manage marketplaces → ⋮ → Sync.
ChatGPT does not show new tools, or asks for a link instead of using an attached file
ChatGPT keeps the tool list from when the server was added. Remove the RevExOS plugin and add it again to refresh it.
parse_invoice says the link returned a web page or a login screen
The link has to download the file directly and publicly. Google Drive links work when shared as "Anyone with the link". For a file on your computer, use the skill instead.