MCP STP/SPEI

Alpha release — published under the alpha npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during 0.x.x-alpha. Install with npm install <pkg>@alpha.

MCP server for STP/SPEI — Mexican instant bank transfer system (equivalent to Brazil's PIX).

Quick Start

# Set your credentials
export STP_API_KEY="your-api-key"
export STP_COMPANY="your-company-id"

# Run via stdio
npx tsx packages/mexico/stp-spei/src/index.ts

# Run via HTTP
npx tsx packages/mexico/stp-spei/src/index.ts --http

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | STP_API_KEY | Yes | API key from STP | | STP_COMPANY | Yes | Company identifier | | MCP_HTTP | No | Set to "true" to enable HTTP transport | | MCP_PORT | No | HTTP port (default: 3000) |

Tools (18)

| Tool | Purpose | |---|---| | create_transfer | Create a SPEI transfer | | get_transfer | Get transfer details by ID | | list_transfers | List transfers with filters | | cancel_transfer | Cancel a pending SPEI orden by clave_rastreo (only works while orden is pending) | | get_balance | Get account balance | | list_account_balances | List balances for all company accounts | | validate_account | Validate a CLABE account number against the receiving bank (online check) | | validate_clabe | Validate CLABE structure and checksum locally (no API call). | | list_banks | List participating SPEI banks | | lookup_bank_by_code | Look up a participating bank by its ABM/SPEI code (first 3 digits of CLABE) | | get_cep | Get CEP (Comprobante Electronico de Pago) for transfer validation | | register_beneficiary | Register a beneficiary account | | create_refund | Create a SPEI refund/devolución for a previously received transfer | | list_refunds | List devoluciones (refunds) by date range | | conciliation_report | Get transactions reconciliation report by date (all received + sent ordenes) | | register_webhook | Register a webhook URL to receive STP event notifications | | list_webhooks | List registered webhooks for the company | | delete_webhook | Delete a registered webhook by ID |

Auth

Uses API key + digital signature authentication. The API key is sent as a Bearer token, and the company identifier is included in requests. Obtain credentials from STP.

API Reference

• STP API Docs

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Authentication

Set these environment variables before launching the server:

• STP_API_KEY (required, secret) — API key for STP
• STP_COMPANY (required) — Company identifier for STP

Issue credentials at the provider's developer portal: https://stpmex.com/docs.

License

MIT