MCP.Market

MyFatoorah MCP server

by kuwaitdevs·io.github.kuwaitdevs/myfatoorah-mcp·v0.1.0

Safely connect AI agents to MyFatoorah payments, invoices, payment methods, and refunds.

B80/100grade B
What users say
No reviews yet
Be the first
Safety scan
B80/100

full report

Adoption
New

0 stars37 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • myfatoorah_api_request

    Escape 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 action

    Creates 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 action

    Creates 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_invoice

    Gets 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_payment

    Gets 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_methods

    List payment methods enabled for this account. Read ApiName from the result and pass it as paymentMethod when creating a hosted payment.

  • myfatoorah_get_refundwrite action

    Gets 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

no findings
  • 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
Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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 build

Set 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.

  • Iugu
    MCP server for iugu — invoices, subscriptions, customers, payment methods
    B
  • Xero
    Xero MCP server for invoices, contacts, payments, quotes, and financial reports.
    A
  • three.ws Tutor
    Read a Pay-As-You-Learn tutoring session's itemized tab and close it for an attested invoice.
    A
  • Yolfi Payments MCP
    Let AI agents add Yolfi crypto checkout, paylinks, webhooks, and status checks.
    A
  • X402 List
    Find and vet x402 payment APIs before your agent pays one: uptime, price, on-chain volume.
    A