About Fixpayment
Fixpayment is a FastMCP server that connects MCP-enabled assistants to the FixPayment creditor portal. Its tools support account operations and reports, with access determined by API key and plan.
Key features
- 01Create and bulk-create accounts
- 02Update account statuses
- 03Attach account documents
- 04View account summaries and lists
- 05Generate account, payment, settlement, and performance reports
- 06Restrict tools by API key and plan
Use cases
- 01Create creditor accounts through an MCP client
- 02Update account status and attach documents
- 03Review payment and settlement reports
- 04Limit available operations by plan
MCP support
The FastMCP server exposes FixPayment account, document, and reporting operations to MCP clients. Each tool requires an API key, which maps to a creditor and plan.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
http://fixpayment.org:8000claude mcp add --transport http fixpayment_mcp http://fixpayment.org:8000{"mcpServers":{"fixpayment_mcp":{"type":"http","url":"http://fixpayment.org:8000"}}}Open in Cursor{"servers":{"fixpayment_mcp":{"type":"http","url":"http://fixpayment.org:8000"}}}Open in VS Code{"mcpServers":{"fixpayment_mcp":{"type":"http","url":"http://fixpayment.org:8000"}}}{"mcpServers":{"fixpayment_mcp":{"serverUrl":"http://fixpayment.org:8000"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
http://fixpayment.org:8000Auth requiredTools
Details
From the project READMEFixPayment MCP Server
A FastMCP server exposing a creditor-facing API for the FixPayment portal.
Connect any MCP-enabled AI assistant (e.g. Claude) to your FixPayment account to create accounts, update statuses, and run reports — all in plain English.
- MCP server URL:
http://fixpayment.org:8000 - Docs:
https://fixpayment.org/mcp/fixpayment-mcp.html - Support: [email protected]
Quick Start
# 1. Clone & install dependencies
pip install -r requirements.txt
# 2. Configure credentials
cp .env.example .env
# Edit .env and set FIXPAYMENT_DB_* variables
# 3. Run the server
python -m mcp.server
# or via FastMCP CLI:
fastmcp run mcp/server.py:mcp
Environment Variables
| Variable | Description | Default |
|---|---|---|
FIXPAYMENT_DB_HOST | PostgreSQL host | localhost |
FIXPAYMENT_DB_PORT | PostgreSQL port | 54432 |
FIXPAYMENT_DB_NAME | Database name | fixpayment_db |
FIXPAYMENT_DB_USER | Database user | fixpayment_user |
FIXPAYMENT_DB_PASS | Database password | (required) |
FIXPAYMENT_UPLOAD_PATH | Upload root directory | /var/www/fixpayment/uploads/ |
Auth Model
Every MCP tool requires an api_key argument.
The key maps to a creditor_id and a plan (basic, reports, or full) in the mcp_api_keys table.
Plans & Tools
| Tool | basic | reports | full |
|---|---|---|---|
ping | ✓ | ✓ | ✓ |
get_plan_info | ✓ | ✓ | ✓ |
get_account_summary | ✓ | ✓ | ✓ |
list_accounts_basic | ✓ | ✓ | ✓ |
validate_account_payload | ✓ | ✓ | ✓ |
accounts_report | ✓ | ✓ | |
payments_report | ✓ | ✓ | |
settlements_report | ✓ | ✓ | |
performance_report | ✓ | ✓ | |
create_account | ✓ | ||
bulk_create_accounts | ✓ | ||
update_account_status | ✓ | ||
add_account_document | ✓ |
Project Structure
fixpayments/
├── mcp/
│ ├── __init__.py
│ ├── server.py # FastMCP instance + entrypoint
│ ├── db.py # DB connection helper
│ ├── auth.py # API key validation
│ └── tools/
│ ├── __init__.py
│ ├── basic.py # Basic plan tools (5 tools)
│ ├── reports.py # Reports plan tools (4 tools)
│ └── accounts.py # Full plan tools (4 tools)
├── docs/
│ └── fixpayment-mcp.html
├── .env.example
├── .gitignore
├── requirements.txt
└── README.md
Database Schema (required tables)
mcp_api_keys—api_key,creditor_id,plan,active,expires_atfixpayment_accounts— accounts tablefixpayment_payments— payments tablefixpayment_settlements— settlements tablefixpayment_account_documents— document attachments
To request an API key or upgrade your plan, email [email protected].
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.