IntegrationsMCP server

Run your payments
from your AI assistant

Connect Grok, Claude, Cursor or any MCP client to your Atoa account through our payments MCP server. Ask in plain English to send a payment link, check who has paid, chase a failed payment or confirm a payout has landed in your bank.

30 tools Hosted at mcp.atoa.me Sandbox and production
Laptop showing an AI assistant listing today's Atoa payments: four paid, £275.50 collected, one failed

What is an MCP server

MCP, the Model Context Protocol, is an open standard that lets an AI assistant use tools from other services. The Atoa MCP server gives your assistant 30 payment tools, including open banking MCP tools for Pay by Bank, that work on your own Atoa account: create a payment request, check its status, search transactions, manage customers and saved cards, issue refunds, and read a connected bank feed.

Atoa hosts it for you, so there is nothing to install. Your assistant sends your Atoa access key with every request and only sees what that key is allowed to see. A sandbox key can only ever reach sandbox data.

Atoa at the centre, connected to a chat assistant, a code editor, a terminal and an AI agent

Works with the AI tools your team already uses

  • GrokCustom connector
  • ClaudeClaude Code
  • ChatGPTOpenAI Agents SDK
  • GeminiGemini CLI
  • Cursormcp.json
  • VS Codemcp.json
  • GitHub CopilotAgent mode
  • WindsurfMCP config
Use cases

Ask, and Atoa
does the admin

Example prompts, several from our sandbox walkthroughs. The figures come from Atoa, the wording from your assistant.

Take payments

Send a payment link in one sentence

Create a £64 link for Emily Clarke’s balayage deposit.
Link ready · £64.00 · INV-2051
pay.atoa.me/… with a QR code to share.
process_paymentcreate_customer
Daily takings

See who paid today, by location

Show today’s payments at Fern and Fade Clifton, including any that failed.
4 paid · £275.50 collected
1 failed · £35 gents cut, FC-2044
get_storesget_transactions
Chase failed payments

Turn a failed payment into a fresh link

FC-2044 failed. Send a new link for the same customer and amount.
New link created for the same customer, £35.00, ref FC-2044-RETRY.
get_transactionsprocess_payment
Bank feed

Confirm a payout has landed

Has Zephyrine Motor Credit paid out on deal BCM-2231?
Landed · £14,250 · 18 Nov, 10:42 UK time
fetch_all_accountsfetch_account_transactions
Refunds

Refund part of an order

Refund £10 of order FC-2043, the customer was overcharged.
Refund started · £10.00 of £45.00 · back to the customer’s bank.
get_refund_paymentsinitiate_refund
Reconcile

Match takings to the bank

Do this week’s Atoa payments match what landed in the bank?
All matched except one settlement still pending from Friday.
get_transactionsfetch_account_transactions
Setup

Connect in two minutes

  1. Copy your access key

    Atoa dashboard › Settings › API Access. Use the Sandbox secret while you test and the Production secret when you go live.

  2. Add Atoa to your assistant

    Point it at https://mcp.atoa.me/mcp with two headers: Authorization: Bearer your key, and X-Atoa-Env set to sandbox or production.

  3. Ask about your payments

    Start with “Show today’s payments”. The key and the environment header must match, or Atoa returns an authentication error.

# Grok › Settings › Connect Apps › Add a custom connector
Name        atoa-payments
Server URL  https://mcp.atoa.me/mcp
Header 1    X-Atoa-Env     sandbox
Header 2    Authorization  Bearer YOUR_ACCESS_KEY

Then attach atoa-payments from the + menu in any chat, or give it to a Grok bot.

Tool catalogue

30 tools across
the payment lifecycle

Your assistant picks the right tool for each request. You never call them by name.

Payments

5

Payment links, QR codes, status and history.

  • process_payment
  • get_payment_status
  • cancel_payment
  • get_transactions
  • get_stores

Customers

5

Find, add and update customer records.

  • create_customer
  • list_customers
  • get_customer
  • update_customer
  • delete_customer

Cards on file

6

Saved cards, repeat charges and card captures.

  • charge_saved_card
  • capture_payment
  • cancel_card_payment
  • list_payment_methods
  • get_payment_method
  • delete_payment_method

Refunds

3

Full and partial refunds, production only.

  • initiate_refund
  • get_refund_payments
  • cancel_refund

Bank feed

6

Read-only Open Banking access to your business account: connect, read balances and transactions, revoke at any time.

  • initiate_ais_auth
  • fetch_all_accounts
  • fetch_account_transactions
  • fetch_account_details
  • fetch_account_balance
  • revoke_account_access

Webhooks

3

Subscribe your systems to payment events.

  • create_webhook
  • list_merchant_webhooks
  • delete_webhook

Account

2

Business settings and supported banks.

  • get_business_config
  • get_institutions

Safe by default

Customers approve every Pay by Bank payment

Customers approve every Pay by Bank payment in their Bank app with Strong Customer Authentication. A saved card can be charged with the customer’s earlier consent, without new approval.

Sandbox first

Sandbox keys reach only test data and the Atoa test bank, where you choose whether a payment completes or fails. Switch the header and key when you go live.

One business and environment per key

Each key works for one business and one environment. A production key can use every tool, so keep it private. Regenerate it in API Access and the old key stops working straight away.

Read-only bank feed

Bank feed tools read balances and transactions. They have no permission to make payments from the connected account, and you can revoke access at any time.

Rate limited per key

The hosted endpoint limits requests per key and answers 429 when it is exceeded, so a runaway agent cannot flood your account.

FCA authorised

Atoa is an Authorised Payment Institution (FRN 1007647), ISO 27001 and SOC 2 certified.

Atoa allows customers to pay via all major Bank apps and cards

A trusted partner
for businesses in the UK

Meet the companies that use our payment solution to power
growth and save more with every payment they accept.

INCREDIBLE
“Since moving to Atoa, we save about £6,000 a month in transaction fees. 96% of our payments are now taken via Atoa.”

Jason Drury

Ponko Motor Company

SUPER CHEAP
“Amazing payment service. Increased our deposit payments by up to 265% in 1 month. Payments super cheap & instant”

Harminder Singh Bains

The Beauty Wardrobe

THE BEST
“Atoa is easy to use for both the customer and consultant. The payment arrives immediately for us… Highly recommended!”

Andy Price

Just Wills & Legal Services

ALL IN ONE
“It’s so nice to see that there are still systems on the market that are not ripping you off with their fees.”

Dora Maries

Holimed Beauty

SIMPLICITY
“We have been very impressed by the ease and simplicity of the payment links. Thanks Atoa, you make fee collection simple!”

Shepsi Haider

Family Law Cafe

SUPERB
“Superb piece of software to simplify taking payments for businesses.”

Malcolm Beattie

MB Motors

BRILLIANT CONCEPT
“Wish we used it earlier! Brilliant concept that is easy to use and saves the company so much on fees.”

Nicolas Colombo

LDN Physio

INSTANT CASH FLOW
“Improves cash flow and saved us over £2,000 a month in payment fees… would 110% recommend it to any other business.”

Lee Shayler

Richlee Motor Company

Yes, with a production key it can charge a card a customer saved with you, using their earlier consent without new approval. Every Pay by Bank payment needs the customer’s approval in their Bank app. Try sandbox first.

No. For Grok you paste the server address and two headers into a form. For Claude Code, Cursor and VS Code it is one command or a few lines of config.

Any client that supports MCP over HTTP with custom headers, including Grok, Claude Code, Cursor, VS Code, GitHub Copilot agent mode and Windsurf. Claude Desktop and Gemini CLI can use the local server, npx @atoapayments/mcp. For ChatGPT and other OpenAI-based products, connect through the OpenAI Agents SDK, which supports MCP servers with headers.

Yes, by telling it. In Grok you can create a bot with one job, such as confirming finance payouts, and instructions never to share the balance. That is an instruction rather than a permission, so give staff the bot and keep the access key to yourself.

Sandbox. Use your Sandbox secret with X-Atoa-Env: sandbox to try every prompt on test data, then switch both to production.

The MCP server lets you run your own Atoa account from an assistant. Agentic payments is for products whose AI agents pay or get paid on a customer’s behalf, within limits a person approves.

Put Atoa in your AI assistant

Book a short demo to see how Atoa helps businesses reduce fees, improve cash flow, and streamline payment operations.
  • About 40% lower payment fees
  • Faster access to funds
  • One platform for modern payments
icon-secure

ISO-27001 and SOC2 Secure

icon-flag

Security backed by UK banks

icon-shield

Authorised by the FCA

Book a demo with Atoa

All fields are required.

By submitting this form, you consent to our Privacy Policy.

or
Calendar Icon

Schedule a quick chat with our team!

Select your preferred time, and our team will give you a short demonstration of how Atoa can work for your business. Book a call

Book a call