{"_id":"@codespar/mcp-stp-spei","_rev":"5-86c06829d2c41ae3d586ad22521792df","name":"@codespar/mcp-stp-spei","dist-tags":{"latest":"0.2.0-alpha.3","alpha":"0.2.0-alpha.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-stp-spei","version":"0.1.0","keywords":["stp","spei","transfers","mexico","banking","clabe","mcp"],"license":"MIT","_id":"@codespar/mcp-stp-spei@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-stp-spei":"dist/index.js"},"dist":{"shasum":"0abf0bb27b506fef01175d30fd01bcebe88a0b66","tarball":"https://registry.npmjs.org/@codespar/mcp-stp-spei/-/mcp-stp-spei-0.1.0.tgz","fileCount":4,"integrity":"sha512-dDCT0RBhUmiFMTWMcKklKTJa0GNFs5KHQeSR0I1pzexz6GdOLHGXJGT6Iu0IlqENugUPlQcHYne5Dn+KU//flA==","signatures":[{"sig":"MEUCIQC/jjOLQsxhpY8TWgSgEHtN+STitx4m23Raqi0ST0YULAIgYjYMtcT7lGVv5JDd3e6C09Xl5qz703nTwdVFo2UTghI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16069},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b6cfd13e835eafffc9f9fec863ef0476792a06d9","mcpName":"io.github.codespar/mcp-stp-spei","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for STP/SPEI — Mexican instant bank transfers","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-stp-spei_0.1.0_1776009982601_0.8156548452215806","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.1":{"name":"@codespar/mcp-stp-spei","version":"0.2.0-alpha.1","keywords":["stp","spei","transfers","mexico","banking","clabe","mcp"],"license":"MIT","_id":"@codespar/mcp-stp-spei@0.2.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-stp-spei":"dist/index.js"},"dist":{"shasum":"bffc44bfcc841506f5ca8d5128ca0ec21200e864","tarball":"https://registry.npmjs.org/@codespar/mcp-stp-spei/-/mcp-stp-spei-0.2.0-alpha.1.tgz","fileCount":4,"integrity":"sha512-A/bmAGuBLHx3Tn2wUHFtnlWGge0vXNxVdUE2Wmm/WHmJ4miiCbrLliJ8SONrdpOnHSasEepAs0AKkM5/lt99Iw==","signatures":[{"sig":"MEQCID4P9hayH6wmOak9qpd4KYgiCXCKC9v8PMgASb1xkH8oAiBz5efn/GA81LdNVUSx7HL1xUhHoGj9e/TPSHoBcMI2Ww==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":26709},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"a9ff36701206eb6feb7fffffc4cbb2a325757082","mcpName":"io.github.codespar/mcp-stp-spei","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for STP/SPEI — Mexican instant bank transfers","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-stp-spei_0.2.0-alpha.1_1777115947681_0.5396479716290967","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.2":{"name":"@codespar/mcp-stp-spei","version":"0.2.0-alpha.2","keywords":["stp","spei","transfers","mexico","banking","clabe","mcp"],"license":"MIT","_id":"@codespar/mcp-stp-spei@0.2.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-stp-spei":"dist/index.js"},"dist":{"shasum":"2fb93bbdb3ed4d71b052c39acfb2c120c43bdeb3","tarball":"https://registry.npmjs.org/@codespar/mcp-stp-spei/-/mcp-stp-spei-0.2.0-alpha.2.tgz","fileCount":4,"integrity":"sha512-Shp3ErbYfUEJfSkjLdp/tKyBr0MJgnj20Tp0thn33yN1HZgCck37/Hzzd1ZEttkEDkQvjvrzoNuucjMwjAfptA==","signatures":[{"sig":"MEUCIBve3GZU2yBiGZ0jrmCgrntvaWN6115+ZbmQHgRtOtaUAiEA2GbwjQkjg7xmuTLT+MEW/MPeMvJUa7llFsWv2YP+EKw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27814},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-stp-spei","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for STP/SPEI — Mexican instant bank transfers","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-stp-spei_0.2.0-alpha.2_1777123148359_0.07337797259925138","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.3":{"name":"@codespar/mcp-stp-spei","version":"0.2.0-alpha.3","description":"MCP server for STP/SPEI — Mexican instant bank transfers","type":"module","main":"dist/index.js","bin":{"mcp-stp-spei":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"license":"MIT","keywords":["stp","spei","transfers","mexico","banking","clabe","mcp"],"mcpName":"io.github.codespar/mcp-stp-spei","_id":"@codespar/mcp-stp-spei@0.2.0-alpha.3","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-HVuw6CgPSbDj5E9Ft00xGEmOEg74kXTMb+MS8MSdpwadmd0e6gVL9iAnBpDsjXmu091KpDdfdlGc4aVtVuv3wg==","shasum":"22d1dbe578dc2431bf484125c58ea1256e3eb154","tarball":"https://registry.npmjs.org/@codespar/mcp-stp-spei/-/mcp-stp-spei-0.2.0-alpha.3.tgz","fileCount":4,"unpackedSize":28704,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCPiqAW7GLYKMDSP1inNmBAlAj1gnkzSfK4Iy+8f566gAIhAOF5cyvZTJgHd5yCP8VEmwBkVVxR4dOTTN8/EgbjYB/w"}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-stp-spei_0.2.0-alpha.3_1782153753046_0.5797478461840297"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-12T16:06:22.494Z","modified":"2026-06-22T18:42:33.355Z","0.1.0":"2026-04-12T16:06:22.749Z","0.2.0-alpha.1":"2026-04-25T11:19:07.831Z","0.2.0-alpha.2":"2026-04-25T13:19:08.486Z","0.2.0-alpha.3":"2026-06-22T18:42:33.224Z"},"license":"MIT","keywords":["stp","spei","transfers","mexico","banking","clabe","mcp"],"description":"MCP server for STP/SPEI — Mexican instant bank transfers","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# MCP STP/SPEI\n\n\n> **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`.\n\nMCP server for **STP/SPEI** — Mexican instant bank transfer system (equivalent to Brazil's PIX).\n\n## Quick Start\n\n```bash\n# Set your credentials\nexport STP_API_KEY=\"your-api-key\"\nexport STP_COMPANY=\"your-company-id\"\n\n# Run via stdio\nnpx tsx packages/mexico/stp-spei/src/index.ts\n\n# Run via HTTP\nnpx tsx packages/mexico/stp-spei/src/index.ts --http\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `STP_API_KEY` | Yes | API key from STP |\n| `STP_COMPANY` | Yes | Company identifier |\n| `MCP_HTTP` | No | Set to `\"true\"` to enable HTTP transport |\n| `MCP_PORT` | No | HTTP port (default: 3000) |\n\n## Tools (18)\n\n| Tool | Purpose |\n|---|---|\n| `create_transfer` | Create a SPEI transfer |\n| `get_transfer` | Get transfer details by ID |\n| `list_transfers` | List transfers with filters |\n| `cancel_transfer` | Cancel a pending SPEI orden by clave_rastreo (only works while orden is pending) |\n| `get_balance` | Get account balance |\n| `list_account_balances` | List balances for all company accounts |\n| `validate_account` | Validate a CLABE account number against the receiving bank (online check) |\n| `validate_clabe` | Validate CLABE structure and checksum locally (no API call). |\n| `list_banks` | List participating SPEI banks |\n| `lookup_bank_by_code` | Look up a participating bank by its ABM/SPEI code (first 3 digits of CLABE) |\n| `get_cep` | Get CEP (Comprobante Electronico de Pago) for transfer validation |\n| `register_beneficiary` | Register a beneficiary account |\n| `create_refund` | Create a SPEI refund/devolución for a previously received transfer |\n| `list_refunds` | List devoluciones (refunds) by date range |\n| `conciliation_report` | Get transactions reconciliation report by date (all received + sent ordenes) |\n| `register_webhook` | Register a webhook URL to receive STP event notifications |\n| `list_webhooks` | List registered webhooks for the company |\n| `delete_webhook` | Delete a registered webhook by ID |\n\n## Auth\n\nUses **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](https://www.stp.mx/).\n\n## API Reference\n\n- [STP API Docs](https://stpmex.com/documentacion)\n\n---\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## Authentication\n\nSet these environment variables before launching the server:\n\n- `STP_API_KEY` *(required, secret)* — API key for STP\n- `STP_COMPANY` *(required)* — Company identifier for STP\n\nIssue credentials at the provider's developer portal: <https://stpmex.com/docs>.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}