Fixpayment

What is Fixpayment?

Fixpayment is a FastMCP server that exposes a creditor-facing API for the FixPayment portal. It allows any MCP-enabled AI assistant (e.g., Claude) to connect to a FixPayment account and perform actions such as creating accounts, updating statuses, and running reports using plain English commands.

How to use Fixpayment?

Install the dependencies with pip install -r requirements.txt, copy and edit .env to set the required FIXPAYMENT_DB_* variables, then run the server with python -m mcp.server or via the FastMCP CLI (fastmcp run mcp/server.py:mcp). Every tool call requires an api_key argument, which maps to a valid API key that must be obtained from FixPayment support.

Key features of Fixpayment

• Exposes 13 tools organized into three plans (basic, reports, full)
• Provides a ping tool for connectivity checks
• Retrieves account summaries and lists accounts
• Generates reports on accounts, payments, settlements, and performance
• Supports creating single or bulk accounts
• Allows updating account statuses and adding documents
• Authenticates every request with an API key

Use cases of Fixpayment

• A creditor queries the current status of all their accounts via an AI assistant
• A collections manager runs a monthly performance report without switching systems
• An operator updates an account status and attaches a new document in one session
• A team bulk-creates accounts from a CSV uploaded to the server's upload directory

FAQ from Fixpayment

What is the Fixpayment MCP server?

It is a FastMCP server that connects AI assistants to the FixPayment portal, letting creditors manage accounts, statuses, and reports through natural language.

What runtime dependencies does Fixpayment require?

It requires a PostgreSQL database, the Python packages in requirements.txt, and the FastMCP framework. The server expects several database tables (mcp_api_keys, fixpayment_accounts, fixpayment_payments, fixpayment_settlements, fixpayment_account_documents) to exist.

How does authentication work?

Every tool requires an api_key argument. The API key is validated against the mcp_api_keys table, which maps the key to a specific creditor_id and a plan (basic, reports, or full).

What plans are available and what tools do they include?

There are three plans: basic (5 tools – ping, get_plan_info, get_account_summary, list_accounts_basic, validate_account_payload), reports (basic plus 4 report tools), and full (reports plus 4 account-management tools: create_account, bulk_create_accounts, update_account_status, add_account_document).

How do I get an API key or upgrade my plan?

Request an API key or plan upgrade by emailing [email protected].