FixPayment

MCP de FixPayment para Acreedores

Documentación

Servidor MCP de FixPayment

Un servidor FastMCP que expone una API orientada a acreedores para el portal FixPayment.
Conecta cualquier asistente de IA compatible con MCP (por ejemplo, Claude) a tu cuenta de FixPayment para crear cuentas, actualizar estados y ejecutar informes, todo en lenguaje natural.

URL del servidor MCP: http://fixpayment.org:8000
Documentación: https://fixpayment.org/mcp/fixpayment-mcp.html
Soporte: support@fixpayment.org

Inicio rápido

# 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

Variables de entorno

Variable	Descripción	Valor predeterminado
`FIXPAYMENT_DB_HOST`	Host de PostgreSQL	`localhost`
`FIXPAYMENT_DB_PORT`	Puerto de PostgreSQL	`54432`
`FIXPAYMENT_DB_NAME`	Nombre de la base de datos	`fixpayment_db`
`FIXPAYMENT_DB_USER`	Usuario de la base de datos	`fixpayment_user`
`FIXPAYMENT_DB_PASS`	Contraseña de la base de datos	(obligatorio)
`FIXPAYMENT_UPLOAD_PATH`	Directorio raíz de carga	`/var/www/fixpayment/uploads/`

Modelo de autenticación

Cada herramienta MCP requiere un argumento api_key.
La clave se asigna a un creditor_id y un plan (basic, reports o full) en la tabla mcp_api_keys.

Planes y herramientas

Herramienta	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`			✓

Estructura del proyecto

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

Esquema de base de datos (tablas requeridas)

mcp_api_keys — api_key, creditor_id, plan, active, expires_at
fixpayment_accounts — tabla de cuentas
fixpayment_payments — tabla de pagos
fixpayment_settlements — tabla de liquidaciones
fixpayment_account_documents — adjuntos de documentos

Para solicitar una clave de API o mejorar tu plan, envía un correo a support@fixpayment.org.