Xaurr

Working Security A

com.xaurr/mcpv1.0.0 Domain verified

Xaurr payments for Ghana, Kenya, Uganda, Nigeria: docs, test checkouts, Payouts, invoices, links

Finance & Payments

Watch Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-11T10:56:26.827385Z",
      "publishedAt": "2026-11-11T10:56:26.827385Z",
      "statusChangedAt": "2026-11-11T10:56:26.827385Z"
    }
  },
  "server": {
    "name": "com.xaurr/mcp",
    "title": "Xaurr",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://mcp.xaurr.com",
        "type": "streamable-http",
        "headers": [
          {
            "name": "Authorization",
            "isSecret": true,
            "description": "Bearer sk_test_... (your Xaurr test API key). Docs and help tools work without it."
          }
        ]
      }
    ],
    "version": "1.0.0",
    "websiteUrl": "https://xaurr.com/?docs=true",
    "description": "Xaurr payments for Ghana, Kenya, Uganda, Nigeria: docs, test checkouts, Payouts, invoices, links"
  }
}

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.xaurr.com

Authorization (optional)

Bearer sk_test_... (your Xaurr test API key). Docs and help tools work without it.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

account_readiness Read-only

This account's own go-live checklist: what is done and what is still missing before live keys take real payments (GET /account/readiness).

This tool takes no arguments.

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Run in a terminal

claude mcp add --transport http mcp https://mcp.xaurr.com

Headers

Authorization (optional, not in the config above): Bearer sk_test_... (your Xaurr test API key). Docs and help tools work without it.

Tools (39)

account_readiness

This account's own go-live checklist: what is done and what is still missing before live keys take real payments (GET /account/readiness).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

check_platform_connection

Xaurr Connect: with the OPERATOR's test key, check they are connected to your platform (GET /platform-connection).

read-only

Argument	Type	Description
platform*	string	Your platform code, PLT-...

Input schema (JSON)

{
  "type": "object",
  "required": [
    "platform"
  ],
  "properties": {
    "platform": {
      "type": "string",
      "description": "Your platform code, PLT-..."
    }
  },
  "additionalProperties": false
}

create_invoice

Create an invoice document (POST /invoices), the same as Create Invoice in the app. Needs a LIVE key: invoices are real documents. Ask the user to confirm first.

destructive

Argument	Type	Description
items*	array
notes	string
currency*	string
due_date	string	YYYY-MM-DD
client_name*	string
client_email	string
client_phone	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "client_name",
    "currency",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "description",
          "quantity",
          "unit_price"
        ],
        "properties": {
          "quantity": {
            "type": "number"
          },
          "unit_price": {
            "type": "number"
          },
          "description": {
            "type": "string"
          }
        }
      }
    },
    "notes": {
      "type": "string"
    },
    "currency": {
      "enum": [
        "GHS",
        "KES",
        "UGX",
        "NGN",
        "USD"
      ],
      "type": "string"
    },
    "due_date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "client_name": {
      "type": "string"
    },
    "client_email": {
      "type": "string"
    },
    "client_phone": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

create_payment_link

Create a reusable payment link (POST /payment-links), paid into your own account in the currency's country. Test key = test link; live key = a real link to share. Ask the user to confirm before creating a live link.

destructive

Argument	Type	Description
title*	string
amount	number \| null	Fixed price, or null to let the payer choose.
currency*	string
description	string
ships_goods	boolean

Input schema (JSON)

{
  "type": "object",
  "required": [
    "title",
    "currency"
  ],
  "properties": {
    "title": {
      "type": "string"
    },
    "amount": {
      "type": [
        "number",
        "null"
      ],
      "description": "Fixed price, or null to let the payer choose."
    },
    "currency": {
      "enum": [
        "GHS",
        "KES",
        "UGX",
        "NGN",
        "USD"
      ],
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "ships_goods": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

create_test_checkout

Create a TEST hosted checkout (POST /checkout-sessions) and return its pay url. Needs a test key with write permission.

destructive

Argument	Type	Description
title	string
amount*	number	The total, at most 2 decimals.
currency*	string
platform	string	Platforms only: your platform code (PLT-...).
cancelUrl	string
reference*	string	Your order number, 1-64 characters.
successUrl*	string	https:// (or http://localhost) return address.
platformFee	number	Platforms only: your own fee on this sale.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "reference",
    "amount",
    "currency",
    "successUrl"
  ],
  "properties": {
    "title": {
      "type": "string"
    },
    "amount": {
      "type": "number",
      "description": "The total, at most 2 decimals."
    },
    "currency": {
      "enum": [
        "GHS",
        "KES",
        "UGX",
        "NGN",
        "USD"
      ],
      "type": "string"
    },
    "platform": {
      "type": "string",
      "description": "Platforms only: your platform code (PLT-...)."
    },
    "cancelUrl": {
      "type": "string"
    },
    "reference": {
      "type": "string",
      "description": "Your order number, 1-64 characters."
    },
    "successUrl": {
      "type": "string",
      "description": "https:// (or http://localhost) return address."
    },
    "platformFee": {
      "type": "number",
      "description": "Platforms only: your own fee on this sale."
    }
  },
  "additionalProperties": false
}

explain_error

Explain an error message returned by the Xaurr API and how to fix it.

read-only

Argument	Type	Description
message*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "message"
  ],
  "properties": {
    "message": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_api_reference

The full reference for one part of the API. Sections: authentication, checkout-sessions, get-checkout, payments, quote, connect, payouts, links-invoices, webhooks, embed, countries.

read-only

Argument	Type	Description
section*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "section"
  ],
  "properties": {
    "section": {
      "enum": [
        "authentication",
        "checkout-sessions",
        "get-checkout",
        "payments",
        "quote",
        "connect",
        "payouts",
        "links-invoices",
        "webhooks",
        "embed",
        "countries"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_checkout

Status of one checkout by your own order reference (GET /checkout-sessions/:reference).

read-only

Argument	Type	Description
reference*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "reference"
  ],
  "properties": {
    "reference": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_openapi

Where to download the machine-readable OpenAPI 3.1 description of the Xaurr API, for code generators and API tools.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

get_payment

One payment by its receipt number (GET /payments/:receipt).

read-only

Argument	Type	Description
receipt*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "receipt"
  ],
  "properties": {
    "receipt": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

go_live_checklist

What is needed before live keys take real payments.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

integration_example

Tested starting code to create a Xaurr checkout from a server, or to verify a webhook. Stacks: node, nextjs, laravel, php, django, flutter, wordpress, webhook.

read-only

Argument	Type	Description
stack*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "stack"
  ],
  "properties": {
    "stack": {
      "enum": [
        "node",
        "nextjs",
        "laravel",
        "php",
        "django",
        "flutter",
        "wordpress",
        "webhook"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

list_invoices

Your invoices, newest first, optionally only unpaid or paid (GET /invoices). Shows which are overdue. Needs a LIVE key: invoices are real documents.

read-only

Argument	Type	Description
limit	number
status	string

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 100,
      "minimum": 1
    },
    "status": {
      "enum": [
        "unpaid",
        "paid"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

list_payment_links

Your payment links for the key's environment, with how many times each was paid (GET /payment-links).

read-only

Argument	Type	Description
limit	number

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 100,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

list_payments

The most recent test payments on the account (GET /payments).

read-only

Argument	Type	Description
limit	number

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 50,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

list_webhooks

Your test webhooks and their last 10 deliveries (GET /webhooks). No secrets are shown.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

mark_invoice_paid

Mark one of your invoices paid (POST /invoices/:id/mark-paid); it is also recorded in bookkeeping. Needs a LIVE key. Ask the user to confirm first.

destructive

Argument	Type	Description
invoice_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "invoice_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

pay_test_checkout

Pay (or fail) a TEST checkout with the right sandbox test number for its country and payout speed, like a customer would, so you see real statuses and webhooks without a phone. Ghana, Kenya and Uganda.

destructive

Argument	Type	Description
outcome	string
reference*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "reference"
  ],
  "properties": {
    "outcome": {
      "enum": [
        "success",
        "fail"
      ],
      "type": "string"
    },
    "reference": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

payout_collection_methods

Xaurr Payouts: the ways a customer can pay in one currency's country (GET /collections/methods).

read-only

Argument	Type	Description
currency*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "currency"
  ],
  "properties": {
    "currency": {
      "enum": [
        "GHS",
        "KES",
        "UGX",
        "NGN"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

payouts_add_worker

Xaurr Payouts: add a test worker (POST /workers). Returns their onboarding_url.

destructive

Argument	Type	Description
name*	string
email	string
phone	string
currency	string
reference*	string	Your own id for them.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name",
    "reference"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "currency": {
      "enum": [
        "GHS",
        "KES",
        "UGX",
        "NGN"
      ],
      "type": "string"
    },
    "reference": {
      "type": "string",
      "description": "Your own id for them."
    }
  },
  "additionalProperties": false
}

payouts_balance

Xaurr Payouts: your test balance (GET /balance), optionally for one currency.

read-only

Argument	Type	Description
currency	string

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "currency": {
      "enum": [
        "GHS",
        "KES",
        "UGX",
        "NGN"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

payouts_collect

Xaurr Payouts: ask a customer to pay into your balance by Mobile Money (POST /collections). Use test_values numbers.

destructive

Argument	Type	Description
phone*	string
amount*	number
worker	string	Optional worker id to credit a share.
currency*	string
reference*	string
payer_name	string
worker_share	number

Input schema (JSON)

{
  "type": "object",
  "required": [
    "amount",
    "currency",
    "phone",
    "reference"
  ],
  "properties": {
    "phone": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "worker": {
      "type": "string",
      "description": "Optional worker id to credit a share."
    },
    "currency": {
      "enum": [
        "GHS",
        "KES",
        "UGX",
        "NGN"
      ],
      "type": "string"
    },
    "reference": {
      "type": "string"
    },
    "payer_name": {
      "type": "string"
    },
    "worker_share": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

payouts_credit_worker

Xaurr Payouts: credit a worker's earnings from your balance (POST /workers/:id/earnings).

destructive

Argument	Type	Description
amount*	number
reference*	string
worker_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "worker_id",
    "amount",
    "reference"
  ],
  "properties": {
    "amount": {
      "type": "number"
    },
    "reference": {
      "type": "string"
    },
    "worker_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

payouts_get_collection

Xaurr Payouts: one collection's status (GET /collections/:id).

read-only

Argument	Type	Description
collection_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "collection_id"
  ],
  "properties": {
    "collection_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

payouts_get_withdrawal

Xaurr Payouts: one payout's status (GET /withdrawals/:id): queued, paid, returned or needs_review.

read-only

Argument	Type	Description
withdrawal_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "withdrawal_id"
  ],
  "properties": {
    "withdrawal_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

payouts_get_worker

Xaurr Payouts: one worker's status, by their id or by your own reference (GET /workers/:id or /workers?reference=).

read-only

Argument	Type	Description
reference	string
worker_id	string

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "reference": {
      "type": "string"
    },
    "worker_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

payouts_pay_worker

Xaurr Payouts: pay a worker out of their earnings (POST /workers/:id/withdrawals). Test money only.

destructive

Argument	Type	Description
amount*	number
reference*	string
worker_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "worker_id",
    "amount",
    "reference"
  ],
  "properties": {
    "amount": {
      "type": "number"
    },
    "reference": {
      "type": "string"
    },
    "worker_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

payouts_test_topup

Xaurr Payouts: add TEST money to your balance (POST /balance/test-topup).

destructive

Argument	Type	Description
amount*	number
currency*	string
reference	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "amount",
    "currency"
  ],
  "properties": {
    "amount": {
      "type": "number"
    },
    "currency": {
      "enum": [
        "GHS",
        "KES",
        "UGX",
        "NGN"
      ],
      "type": "string"
    },
    "reference": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

payouts_worker_history

Xaurr Payouts: one worker's earnings and payouts (GET /workers/:id/history).

read-only

Argument	Type	Description
worker_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "worker_id"
  ],
  "properties": {
    "worker_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

platform_earnings

Platforms (Xaurr Connect): your fee earnings per currency and the latest ones, for the key's environment (GET /platform/earnings). Use your own platform key.

read-only

Argument	Type	Description
currency	string

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "currency": {
      "enum": [
        "GHS",
        "KES",
        "UGX",
        "NGN"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

platform_operators

Platforms (Xaurr Connect): every operator connected to your platform, with country, agreed maximum fee and whether they can take live payments (GET /platform/operators). Use your own platform LIVE key.

read-only

Argument	Type	Description
status	string

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "status": {
      "enum": [
        "active",
        "disconnected"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

quote_fees

What a payment costs in Ghana cedis (GET /quote): what the customer pays, the fees, and what you receive.

read-only

Argument	Type	Description
kind	string
mode	string
amount*	number
method	string
payout_to	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "amount"
  ],
  "properties": {
    "kind": {
      "enum": [
        "in_app",
        "storefront",
        "plugin",
        "fundraiser",
        "rent",
        "susu",
        "plan",
        "bulk"
      ],
      "type": "string"
    },
    "mode": {
      "enum": [
        "receive",
        "charge"
      ],
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "method": {
      "enum": [
        "mobile_money",
        "bank_transfer",
        "card"
      ],
      "type": "string"
    },
    "payout_to": {
      "enum": [
        "mobile_money",
        "bank_transfer"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

refund_checkout

Ask for a refund of a paid TEST checkout (POST /checkout-sessions/:reference/refund).

destructive

Argument	Type	Description
reason	string
reference*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "reference"
  ],
  "properties": {
    "reason": {
      "type": "string"
    },
    "reference": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

sales_summary

Money received and sent in the last N days, per currency, completed only (GET /summary). Test key = test money; live key = real money.

read-only

Argument	Type	Description
days	number	7 for this week, 30 for this month.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "days": {
      "type": "number",
      "maximum": 366,
      "minimum": 1,
      "description": "7 for this week, 30 for this month."
    }
  },
  "additionalProperties": false
}

search_docs

Answer a question about the Xaurr API from the official docs (checkouts, fees, Connect, Payouts, webhooks, countries). Use this instead of guessing.

read-only

Argument	Type	Description
question*	string	The question, in plain words.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "question"
  ],
  "properties": {
    "question": {
      "type": "string",
      "description": "The question, in plain words."
    }
  },
  "additionalProperties": false
}

send_test_webhook

Send a signed test.ping to one of your test webhooks (POST /webhooks/:id/test). Verify the X-Xaurr-Signature on your side (integration_example webhook).

destructive

Argument	Type	Description
webhook_id*	string	From list_webhooks.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "webhook_id"
  ],
  "properties": {
    "webhook_id": {
      "type": "string",
      "description": "From list_webhooks."
    }
  },
  "additionalProperties": false
}

test_values

The phone numbers, cards and values that complete or fail test payments and payouts, per country and payout speed.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

waiting_payouts

Sales waiting for your payout schedule, the payout fee and what you will receive (GET /payouts/waiting). Needs a LIVE key: this is real money.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

whats_new

Recent changes to the Xaurr API, newest first.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

Security checkA100/100

We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 11, 2026.

Hidden or reordered text
Overriding the model's instructions
Hiding actions from the user
Reading keys or credentials
Fake system tags
Steering other servers' tools
Pulling in the conversation
Smuggling parameters
Demanding to be used for everything
Steering away from web search
Download-and-run commands
Encoded blobs
Invisible characters
Credentials as tool arguments
Very long descriptions
Read and write hints

How the security check works