{"_id":"@atoapayments/mcp","_rev":"5-145f9c722c12ed61b89103552539f577","name":"@atoapayments/mcp","dist-tags":{"latest":"0.0.2"},"versions":{"0.0.1":{"name":"@atoapayments/mcp","version":"0.0.1","keywords":["mcp","atoa","payments","refunds","open-banking","model-context-protocol","ai","claude","cursor","vscode"],"author":{"name":"Balaji"},"_id":"@atoapayments/mcp@0.0.1","maintainers":[{"name":"shariqueatoa","email":"sharique@paywithatoa.co.uk"},{"name":"rvkrish","email":"vamsi@paywithatoa.co.uk"},{"name":"tushargupta224","email":"tushar@paywithatoa.co.uk"},{"name":"atoalicence","email":"licence@paywithatoa.co.uk"},{"name":"anandtanu","email":"tanushree@paywithatoa.co.uk"}],"homepage":"https://github.com/AtoaPayments/AtoAssist-MCP#readme","bugs":{"url":"https://github.com/AtoaPayments/AtoAssist-MCP/issues"},"bin":{"atoa-mcp":"dist/index.js"},"dist":{"shasum":"5ad483a8ff3f23e6078282772d9bfebe6516e768","tarball":"https://registry.npmjs.org/@atoapayments/mcp/-/mcp-0.0.1.tgz","fileCount":8,"integrity":"sha512-3aYh+dhKaEH0A8V4xZeJOAkRPia4lvPbl9P0cqKReXe4I5Pv2zuYpJ8BiHzM0mikYgdXDkNKgLJCNa5aulVt2Q==","signatures":[{"sig":"MEYCIQCy3Ablq9d5NYlxANbbICL9KrCNJzWV0Pe1VCyExbut7wIhAPh7jn0TBBF2tgq2Jz6IqK6xFKJh2XriQgz5+yj+/w4W","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27234},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"c506b11b64cb6fd9929c09dc1ceb8d92e94477f9","scripts":{"lint":"eslint \"{src,tests}/**/*.ts\" --fix","pack":"npm run build && npm pack","build":"tsc","test:mcp":"vitest run --config vitest.mcp.config.ts","lint:check":"eslint \"{src,tests}/**/*.ts\"","start:http":"node dist/index.js --http --target=prod","start:proxy":"node dist/index.js","start:stdio":"node dist/index.js --stdio --target=prod","test:mcp:all":"vitest run --config vitest.mcp.config.ts tests/mcp/__tests__/","test:mcp:fuzz":"vitest run --config vitest.mcp.config.ts tests/mcp/__tests__/fuzz.test.ts","prepublishOnly":"npm run build","start:http:dev":"node dist/index.js --http --target=dev","start:http:uat":"node dist/index.js --http --target=uat","test:mcp:watch":"vitest --config vitest.mcp.config.ts","start:stdio:dev":"node dist/index.js --stdio --target=dev","start:stdio:uat":"node dist/index.js --stdio --target=uat","start:http:local":"node dist/index.js --http --port=3100 --base-url=http://localhost/server/api","start:proxy:local":"node dist/index.js --local","test:mcp:integration":"vitest run --config vitest.mcp.config.ts tests/mcp/__tests__/integration.test.ts"},"_npmUser":{"name":"atoalicence","email":"licence@paywithatoa.co.uk"},"overrides":{"minimatch":"^9.0.7"},"repository":{"url":"git+https://github.com/AtoaPayments/AtoAssist-MCP.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Atoa payment integration — process payments, refunds, bank feeds and more","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^4.3.6","pino":"^10.3.1","axios":"^1.11.0","nanoid":"^5.0.4","express":"^5.2.1","express-rate-limit":"^8.3.1","@modelcontextprotocol/sdk":"^1.27.0"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^8.57.1","vitest":"^4.0.18","prettier":"^3.8.1","fast-check":"^4.6.0","typescript":"^5.3.2","@types/node":"^20.10.0","@types/express":"^5.0.6","@vitest/coverage-v8":"^4.0.18","eslint-config-prettier":"^9.1.2","eslint-plugin-prettier":"^5.5.5","@typescript-eslint/parser":"^6.21.0","@typescript-eslint/eslint-plugin":"^6.21.0"},"optionalDependencies":{"pino-pretty":"^13.1.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.0.1_1775649834194_0.45204036278076254","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@atoapayments/mcp","version":"0.0.2","description":"MCP server for Atoa payment integration — process payments, refunds, bank feeds and more","author":{"name":"Balaji"},"homepage":"https://github.com/AtoaPayments/AtoAssist-MCP#readme","bugs":{"url":"https://github.com/AtoaPayments/AtoAssist-MCP/issues"},"repository":{"type":"git","url":"git+https://github.com/AtoaPayments/AtoAssist-MCP.git"},"main":"dist/index.js","type":"module","bin":{"atoa-mcp":"dist/index.js"},"engines":{"node":">=18"},"scripts":{"build":"tsc","start:http":"node dist/index.js --http --target=prod","start:http:local":"node dist/index.js --http --port=3100 --base-url=http://localhost/server/api","start:http:dev":"node dist/index.js --http --target=dev","start:http:uat":"node dist/index.js --http --target=uat","start:stdio":"node dist/index.js --stdio --target=prod","start:stdio:dev":"node dist/index.js --stdio --target=dev","start:stdio:uat":"node dist/index.js --stdio --target=uat","start:proxy":"node dist/index.js","start:proxy:local":"node dist/index.js --local","pack":"npm run build && npm pack","prepublishOnly":"npm run build","test:mcp":"vitest run --config vitest.mcp.config.ts","test:mcp:watch":"vitest --config vitest.mcp.config.ts","test:mcp:fuzz":"vitest run --config vitest.mcp.config.ts tests/mcp/__tests__/fuzz.test.ts","test:mcp:integration":"vitest run --config vitest.mcp.config.ts tests/mcp/__tests__/integration.test.ts","test:mcp:all":"vitest run --config vitest.mcp.config.ts tests/mcp/__tests__/","lint":"eslint \"{src,tests}/**/*.ts\" --fix","lint:check":"eslint \"{src,tests}/**/*.ts\""},"keywords":["mcp","atoa","payments","refunds","open-banking","model-context-protocol","ai","claude","cursor","vscode"],"dependencies":{"@modelcontextprotocol/sdk":"^1.27.0","axios":"^1.11.0","express":"^5.2.1","express-rate-limit":"^8.3.1","nanoid":"^5.0.4","pino":"^10.3.1","zod":"^4.3.6"},"optionalDependencies":{"pino-pretty":"^13.1.3"},"overrides":{"minimatch":"^9.0.7"},"devDependencies":{"@types/express":"^5.0.6","@types/node":"^20.10.0","@typescript-eslint/eslint-plugin":"^6.21.0","@typescript-eslint/parser":"^6.21.0","@vitest/coverage-v8":"^4.0.18","eslint":"^8.57.1","eslint-config-prettier":"^9.1.2","eslint-plugin-prettier":"^5.5.5","fast-check":"^4.6.0","prettier":"^3.8.1","typescript":"^5.3.2","vitest":"^4.0.18"},"_id":"@atoapayments/mcp@0.0.2","gitHead":"493e48f346ccecace56e474ed27c88d7c944b1bc","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-fARSk9ydIlR8v+5D2VXa5orv5ayOmCC+WUedBOAXDLArnLAhs0SEVIBck+U6KmrTkiY2sgsXkCKuUlaBytcAzA==","shasum":"707addce86d2a00946e4ac15958a9652ec455480","tarball":"https://registry.npmjs.org/@atoapayments/mcp/-/mcp-0.0.2.tgz","fileCount":8,"unpackedSize":27261,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC6+t2EI+Cz2eig4QoJ2Gu8BfBfMB57+rbvxhcgSFaaUAIhANBVKcFPvTS/MYB12H+gAfLdB3XM59aUHYpd5f8QoXJ5"}]},"_npmUser":{"name":"atoalicence","email":"licence@paywithatoa.co.uk"},"directories":{},"maintainers":[{"name":"shariqueatoa","email":"sharique@paywithatoa.co.uk"},{"name":"rvkrish","email":"vamsi@paywithatoa.co.uk"},{"name":"tushargupta224","email":"tushar@paywithatoa.co.uk"},{"name":"atoalicence","email":"licence@paywithatoa.co.uk"},{"name":"anandtanu","email":"tanushree@paywithatoa.co.uk"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.0.2_1775655660609_0.0069649092241077515"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-08T12:03:54.104Z","modified":"2026-04-08T13:41:00.995Z","1.0.0":"2026-04-08T10:46:26.649Z","0.0.1":"2026-04-08T12:03:54.328Z","0.0.2":"2026-04-08T13:41:00.789Z"},"bugs":{"url":"https://github.com/AtoaPayments/AtoAssist-MCP/issues"},"author":{"name":"Balaji"},"homepage":"https://github.com/AtoaPayments/AtoAssist-MCP#readme","keywords":["mcp","atoa","payments","refunds","open-banking","model-context-protocol","ai","claude","cursor","vscode"],"repository":{"type":"git","url":"git+https://github.com/AtoaPayments/AtoAssist-MCP.git"},"description":"MCP server for Atoa payment integration — process payments, refunds, bank feeds and more","maintainers":[{"name":"shariqueatoa","email":"sharique@paywithatoa.co.uk"},{"name":"rvkrish","email":"vamsi@paywithatoa.co.uk"},{"name":"tushargupta224","email":"tushar@paywithatoa.co.uk"},{"name":"atoalicence","email":"licence@paywithatoa.co.uk"},{"name":"anandtanu","email":"tanushree@paywithatoa.co.uk"}],"readme":"# Atoa MCP Server\n\nThe Atoa [Model Context Protocol](https://modelcontextprotocol.io/) server allows you to integrate with Atoa payment APIs through function calling. This server provides tools to process payments, manage customers, handle refunds, access bank feeds, configure webhooks, and more.\n\n[![npm](https://img.shields.io/npm/v/@atoapayments/mcp)](https://www.npmjs.com/package/@atoapayments/mcp)\n[![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org/)\n[![License](https://img.shields.io/badge/license-ISC-blue)]()\n\n## Setup\n\nYou'll need an Atoa SDK Token from the [Atoa Dashboard](https://dashboard.paywithatoa.co.uk/login).\n\n### Quick Start\n\nRun the interactive setup wizard:\n\n```bash\nnpx @atoapayments/mcp init\n```\n\nThis will guide you through setup and provide the configuration to add to your MCP client.\n\n### Manual Setup\n\n```bash\nnpx -y @atoapayments/mcp --auth-token=YOUR_AUTH_TOKEN --env=sandbox\n```\n\nReplace `YOUR_AUTH_TOKEN` with your actual Atoa SDK token. Alternatively, set the `ATOA_AUTH_TOKEN` environment variable.\n\n**Note:** Use `--env=sandbox` for testing and `--env=production` when you're ready to go live.\n\n## Client Configuration\n\n### Claude Desktop\n\nAdd the following to your `claude_desktop_config.json` ([location guide](https://modelcontextprotocol.io/quickstart/user)):\n\n```json\n{\n  \"mcpServers\": {\n    \"atoa\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@atoapayments/mcp\", \"--auth-token=YOUR_AUTH_TOKEN\", \"--env=sandbox\"]\n    }\n  }\n}\n```\n\n> macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` · Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add atoa -- npx -y @atoapayments/mcp --auth-token=YOUR_AUTH_TOKEN --env=sandbox\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"atoa\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@atoapayments/mcp\", \"--auth-token=YOUR_AUTH_TOKEN\", \"--env=sandbox\"]\n    }\n  }\n}\n```\n\n### VS Code\n\nAdd to `.vscode/mcp.json` in your project root:\n\n```json\n{\n  \"servers\": {\n    \"atoa\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@atoapayments/mcp\", \"--auth-token=YOUR_AUTH_TOKEN\", \"--env=sandbox\"]\n    }\n  }\n}\n```\n\n### Gemini CLI\n\n```bash\ngemini mcp add -s user -- atoa npx -y @atoapayments/mcp --auth-token=YOUR_AUTH_TOKEN --env=sandbox\n```\n\n### Windsurf\n\nAdd to your Windsurf MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"atoa\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@atoapayments/mcp\", \"--auth-token=YOUR_AUTH_TOKEN\", \"--env=sandbox\"]\n    }\n  }\n}\n```\n\n## Configuration Options\n\n| Flag | Required | Default | Description |\n| --- | --- | --- | --- |\n| `--auth-token` | Yes | — | Atoa SDK access token |\n| `--env` | No | `sandbox` | `sandbox` or `production` |\n| `--payment-redirect-url` | No | — | Redirect URL after payment completion |\n| `--ais-redirect-url` | No | — | Redirect URL after bank authorization |\n\n## Available Tools\n\nTools are available across Payments, Customers, Payment Methods, Card on File, Refunds, Webhooks, Bank Feeds (AIS), and more.\n\nSee the [Atoa MCP documentation](https://docs.atoa.me/mcp-server) for the full list of tools and debugging guides.\n\n## Troubleshooting\n\n| Problem | Fix |\n| --- | --- |\n| `Merchant not found` | Check your auth token is valid and active in the [Atoa Dashboard](https://dashboard.paywithatoa.co.uk/login) |\n| Connection timeout | Verify your network can reach `mcp.atoa.me` |\n| `cancel_refund` fails in sandbox | This is production-only. Use `refundNotes: \"FAILURE TEST\"` with `initiate_refund` to simulate |\n| Store not found | Verify the store is enabled in the [Atoa Dashboard](https://dashboard.paywithatoa.co.uk/login) |\n\n## License\n\nProprietary - [Atoa Payments Limited](https://paywithatoa.co.uk/)\n","readmeFilename":"README.md"}