io.github.codespar/mcp-stp-spei — MCP Server for STP/SPEI

This Model Context Protocol (MCP) server provides STP/SPEI support for Mexican instant bank transfers, described as equivalent to Brazil’s PIX. It is published as an alpha release and follows public endpoint paths aligned with BACEN/provider conventions, with guidance to pin versions during 0.x.x-alpha.

🛠️ Key Features

MCP server focused on STP/SPEI (Mexican instant bank transfers)
Alpha release distributed under the alpha npm dist-tag
Endpoint paths follow public docs and BACEN/provider conventions (not fully live-validated)

🚀 Use Cases

Integrate Mexican instant transfer (STP/SPEI) into LLM tools via MCP
Build agentic commerce or fintech payment workflows for Latin America

⚡ Developer Benefits

Clear installation/run instructions for alpha builds (pin exact 0.x.x-alpha versions)
Supports execution via stdio (npx tsx .../src/index.ts) and HTTP (npx tsx .../src/)

⚠️ Limitations

Alpha status; endpoint paths “have not been fully live-validated”
Requires STP API credentials (STP_API_KEY, STP_COMPANY) as environment variables

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).

# 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

Variable

Required

Description

STP_API_KEY

Yes

API key from STP

STP_COMPANY

Yes

Company identifier

MCP_HTTP

Set to "true" to enable HTTP transport

MCP_PORT

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

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

list_webhooks

List registered webhooks for the company

delete_webhook

Delete a registered webhook by ID

Install

Configuration

Environment variables

STP_API_KEYrequiredsecret

API key for STP

STP_COMPANYrequired

Company identifier for STP

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-stp-spei": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-stp-spei@0.2.0-alpha.3"
      ],
      "env": {
        "STP_API_KEY": "<YOUR_STP_API_KEY>",
        "STP_COMPANY": "<YOUR_STP_COMPANY>"
      }
    }
  }
}

io.github.codespar/mcp-stp-spei