For Creditors

FixPayment MCP for Creditors

Connect your AI tools directly to the FixPayment creditor portal. Create accounts, update statuses, and run reports with your live FixPayment data.

Docs: https://fixpayment.org/mcp/fixpayment-mcp.html · MCP server: http://fixpayment.org:8000

What you can do

From your AI assistant, using plain English:

  • Create accounts (recovery or reminder) tied to your FixPayment creditor ID.
  • Update statuses to active, paid, settled, closed, etc.
  • Run portal-grade reports (accounts, payments, settlements, performance).
  • List accounts in bulk, without exposing debtor PII.

FastMCP server details

Built on FixPayment’s production payment resolution portal used daily by creditors to recover unpaid invoices.

Server name
fixpayment-cred-portal
Transport

Standard MCP (stdio or HTTP) using fastmcp in Python.

HTTP MCP server URL

http://fixpayment.org:8000 (your workspace or tooling may use this URL when adding a custom MCP server).

Auth

Every tool takes an api_key argument. That key maps to a creditor_id and a plan in our database.

Works with

You can connect this server to any MCP-enabled AI assistant (for example Claude, or other tools that support custom MCP servers). Once connected, your assistant can call tools like create_account or accounts_report directly against your FixPayment data.

Scoped per creditor

Connect from Claude and other MCP assistants

Use FixPayment from Claude

  • “Create a reminder account for invoice INV‑2026‑00123 for $1,250 due next month.”
  • “Show me a status and balance summary for all my reminder accounts.”
  • “Close the account for debtor Jane Smith that was just fully paid.”

Claude turns these into MCP tool calls like create_account, accounts_report, and update_account_status against your FixPayment data.

What your MCP client does under the hood

Your MCP client sends simple JSON calls (tool name + arguments). You don’t have to hand‑craft them—once configured, the assistant does it for you.

Plans and tools

All tools require an API key. Your plan controls which tools you can use:

Basic (included)

basic
  • ping – connectivity and plan check.
  • get_plan_info – see which tools this key can use.
  • get_account_summary – status/type/balance for a single account.
  • list_accounts_basic – paginated list of accounts (no PII).
  • validate_account_payload – dry-run validation for creating accounts.

Great for dashboards, summaries, and testing.

Reports

reports
  • accounts_report – status + balance breakdown (with service_type filter).
  • payments_report – totals and by-method breakdown over a date range.
  • settlements_report – totals and by-status breakdown.
  • performance_report – total collected, collection rate, monthly trend.

Same numbers as your creditor “Reports” page, now inside your AI assistant.

Full API

full
  • create_account – minimal account creation (creditor_id from your key).
  • bulk_create_accounts – bulk-create multiple accounts in one call.
  • update_account_status – change account status for your own accounts.
  • add_account_document – attach PDFs/contracts to an existing account.
  • Includes everything from Basic and Reports.

For deeper automation and tight integration with your own systems.

How to use it from an AI app

  1. Get an API key from FixPayment.
  2. Add the MCP server in your AI tool.
    Use http://fixpayment.org:8000 (HTTP) or your internal endpoint in the tool’s custom MCP server settings.
  3. Talk to your assistant.
    Ask it to create accounts, update statuses, or run FixPayment reports—it will call the MCP tools for you.

Security & scope

FixPayment’s MCP server is designed so that:

If an AI agent calls a tool above its plan, the server responds with a clear “plan required” error.