Connecting Claude to the Billtrust MCP Server

Overview

This guide walks through adding the Billtrust MCP Server as an MCP server action in Claude so that Claude can answer questions about your invoicing, payments, cash application, and open receivables data.

The tool is read-only. It answers questions about your accounts receivable data and never creates, changes, or deletes anything.

Before you begin

The following requirements must be met before connecting Claude to the Billtrust MCP Gateway.

 

Requirement

Detail

Network access

The gateway is internet-accessible over HTTPS.

No VPN required.

Billtrust credentials

Each end-user needs an active Billtrust account.

The gateway authenticates users either via corporate SSO (Cognito/SAML) or email + password.

 

Step-by-step guide

Step 1: The MCP endpoint URL

Use the multi-tenant MCP endpoint:

Environment

MCP Endpoint

Production

https://mcp.us.billtrust.com/mcp

 

Users log in via an email-first form. The gateway looks up their default tenant automatically.

 

Step 2: Add the MCP server in Claude

A user with Claude admin access follow the steps below:

 

  1. Navigate to Connectors in Claude.

  2. Select Add Custom.

  3. Click Web.

  4. Enter the MCP name. For example: Billtrust MCP

  5. Enter the MCP endpoint in the Server URL field.

  6. Click Save.

Step 3: Verify Billtrust account access

Access to the Billtrust data within the agent is controlled by the MCP Gateway's OAuth layer — every user must also have an active Billtrust account. Before sharing the agent, confirm:

 

  • The user has an active Billtrust account.

  • For authentication via SSO — the user's Microsoft / Cognito identity is linked to their Billtrust account.

  • For direct login — the user knows their Billtrust email + password.

 

Users without a Billtrust account will be able to open the agent but will see an "Email not recognized" error when the agent first tries to call a Billtrust tool. See the Troubleshooting slide for resolution steps.

NOTE   

An active Billtrust account is required but is not enough on its own. Access to the tool is checked on every request. If your tenant or user account is not entitled to the tool, it will not appear in Claude even after a successful sign-in.

What you can ask

The connector exposes one tool, Query Billtrust AR data (technical name: query_billtrust_data). Ask a natural-language question about your Billtrust accounts receivable data, and Claude returns a written answer grounded in your data.

The tool covers four analytical domains. Which domains are available to you depends on your tenant configuration and your user permissions. Both are checked on every request.

Domain Example question
AR / Open Balance “What are our total open receivables right now?”
Invoicing “What is the aging of our invoiced amounts?”
Payments “What is our on-time versus late payment rate this quarter?”
Cash Application “What is our current unapplied cash total?”

 

NOTE   

The tool does not have access to Billtrust Collections or Billtrust Credit. If a domain or the tool itself is not enabled for your tenant or user account, it will not appear in Claude, even after you sign in.

Troubleshooting

 

"Authorization server metadata is invalid" on connect
The gateway's OAuth discovery response must have an issuer that matches the host you connected to (https://mcp.us.billtrust.com for prod). If you see this error, verify:

(1) You are using https:// (not http://).
(2) The URL ends in /mcp — omitting the path causes the well-known handler to return a 404.

 

User sees Email not recognized during sign-in
The email entered does not have a Billtrust account on this tenant. Confirm the user exists in Billtrust and their account is active.


Session expired after 30 days
Expected behavior — the 30-day session cap fired. The user needs to re-authenticate. Claude triggers this automatically on the next tool call that returns 401 invalid_token.

 

Privacy and support

For details on how Billtrust collects, uses, stores, and retains data, see the Billtrust privacy policy at https://www.billtrust.com/legal/privacy-policy.

For questions or issues, contact Billtrust support at support@billtrust.com.