MyFatoorah MCP server
io.github.kuwaitdevs/myfatoorah-mcp·v0.1.0Safely connect AI agents to MyFatoorah payments, invoices, payment methods, and refunds.
0 stars37 downloads/wk
Reviews
Write oneNobody has reviewed MyFatoorah MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
MyFatoorah MCP tools (7, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
myfatoorah_api_requestEscape hatch for documented MyFatoorah v2/v3 endpoints not covered by another tool. Accepts only safe relative /v2/ or /v3/ paths and GET, POST, or PUT. Absolute URLs are blocked so credentials cannot be sent elsewhere. POST/PUT require confirm=true.
myfatoorah_create_paymentwrite actionCreates a payment/invoice using POST /v3/payments. In a live environment this creates a real payable invoice. Omit paymentMethod to show all enabled methods; use notificationOption for invoicing. The returned PaymentURL is where the customer pays.
myfatoorah_create_refundwrite actionCreates a real full or partial refund using POST /v3/refunds. This moves money in live environments. Call only after the user explicitly approves the exact PaymentId and amount; confirm must be true.
myfatoorah_get_invoiceGets an invoice by exactly one lookup type. Invoice ID uses /v3/invoices/{value}; external identifier returns the most recent matching invoice and uses /v3/invoices/externalIdentifier/{value}.
myfatoorah_get_paymentGets authoritative payment details by PaymentId using GET /v3/payments/{paymentId}. Treat payment as successful only when Invoice.Status is PAID and Transaction.Status is SUCCESS.
myfatoorah_get_payment_methodsList payment methods enabled for this account. Read ApiName from the result and pass it as paymentMethod when creating a hosted payment.
myfatoorah_get_refundwrite actionGets a refund by RefundId using GET /v3/refunds/{refundId}. Refund statuses include Refunded, Canceled, and Pending.
Public scan report
scanner v0.1.10 · 2026-10-31 · same rubric, same numbers if you re-run it
- Code scan14 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 65 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
How MyFatoorah MCP compares
Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 80/100
- higher than 65% of 1,761 Finance servers
- Tools
- 7
- the typical Finance server has 8
- Tools that change things
- 43%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 37
- more than 30% of 421 Finance servers with a package
What its tools let an agent do: 4 read · 3 change
Install MyFatoorah MCP in Claude Code, Cursor or VS Code
Runs npx -y myfatoorah-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add myfatoorah-mcp -- npx -y myfatoorah-mcp
What the publisher says
From the MyFatoorah MCP repository's README, as published. We do not edit it. Read it on GitHub
MyFatoorah MCP
An LLM-friendly Model Context Protocol server for the MyFatoorah API. It lets Claude, VS Code, Cursor, and other MCP hosts discover payment methods, create payment links, verify payments, inspect invoices, and manage refunds through focused tools.
This is an independent community project, not an official MyFatoorah product. Test in the sandbox before using a live account.
For step-by-step host setup, Inspector testing, agent prompts, payment verification, refunds, and troubleshooting, see the usage guide.
Requirements
- Node.js 20 or newer
- A MyFatoorah API token with only the permissions required by the tools you use
Setup
npm install
cp .env.example .env
npm run buildSet MYFATOORAHAPITOKEN in the MCP host's environment. The server does not automatically load .env; the VS Code debug configuration does.
Environment variables
Kuwait also covers the shared Bahrain, Jordan, and Oman API origin. Multi-country accounts use a separate token for each country.
Connect an MCP host
Use an absolute path in host configurations. Replace /absolute/path/to/myfatoorah-mcp and the token placeholder locally.
Claude Desktop
Add this server to Claude Desktop's MCP configuration:
{
"mcpServers": {
"myfatoorah": {
"command": "node",
"args": ["/absolute/path/to/myfatoorah-mcp/dist/index.js"],
"env": {
"MYFATOORAH_API_TOKEN": "YOUR_TOKEN",
"MYFATOORAH_ENVIRONMENT": "test"
}
}
}
}Restart Claude Desktop after saving the configuration.
Claude Code
Project-scoped configuration can use .mcp.json (keep it uncommitted if it contains a token):
{
"mcpServers": {
"myfatoorah": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/myfatoorah-mcp/dist/index.js"],
"env": {
"MYFATOORAH_API_TOKEN": "YOUR_TOKEN",
"MYFATOORAH_ENVIRONMENT": "test"
}
}
}
}VS Code / GitHub Copilot
The included .vscode/mcp.json launches the built server and securely prompts for a token. Build once, open the MCP servers view, then start myfatoorah. The token is not stored in the repository.
Cursor and generic stdio hosts
Use the same command, args, and env values as the Claude Desktop example. MCP protocol messages use stdin/stdout; server diagnostics must use stderr.
After publishing to npm, hosts can instead launch it with npx -y myfatoorah-mcp.
Tools
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Grade history
- 2026-10-31downgradeA → Bscore 80
MyFatoorah MCP: common questions
- Is MyFatoorah MCP server safe?
- Mostly: it is graded B (80/100). Read the MyFatoorah MCP safety report
- How do I install MyFatoorah MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does MyFatoorah MCP need an API key?
- Yes. The registry entry asks for
MYFATOORAH_API_TOKEN. - Is MyFatoorah MCP maintained?
- The last commit was 69 days ago (2026-08-27). The latest release is v0.1.0.
- What can I use instead of MyFatoorah MCP?
- Servers from other publishers that do the same job: Iugu MCP server, Xero MCP server and three.ws Tutor MCP server.
- How does MyFatoorah MCP compare with other Finance MCP servers?
- safety score 80/100 (higher than 65% of 1,761 Finance servers); tools 7 (the typical Finance server has 8); tools that change things 43% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to MyFatoorah MCP
Same job from other publishers: the closest match first, then the best rated.
- not reviewedGrowingB
- XeroXero MCP server for invoices, contacts, payments, quotes, and financial reports.not reviewedGrowingA
- three.ws TutorRead a Pay-As-You-Learn tutoring session's itemized tab and close it for an attested invoice.not reviewedEstablishedA
- Yolfi Payments MCPLet AI agents add Yolfi crypto checkout, paylinks, webhooks, and status checks.not reviewedEstablishedA
- X402 ListFind and vet x402 payment APIs before your agent pays one: uptime, price, on-chain volume.not reviewedEstablishedA