How to Use the SimpleFatoora MCP in Claude Code

Q: How do I check SimpleFatoora status with Claude Code?

You run the single command: checksimplefatoorastatus. This confirms connectivity and API health without needing a GUI. It's ideal for pre-flight checks in automated pipelines.

Q: Does SimpleFatoora support complex invoice types with Claude Code?

It handles all standard compliance needs. Use createvatinvoice for B2B transactions, or use createdebitnote when a payment adjustment is necessary. The server manages the required ZATCA structures.

Automate your accounting scripts with SimpleFatoora using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect SimpleFatoora MCP to Claude Code

Create your Vinkius account to connect SimpleFatoora to Claude Code — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup SimpleFatoora with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Run Batch Customer Operations

Need to clean up old records? You can pipe a list of IDs into the agent which runs `delete_customer` for bulk cleanup. Similarly, if you need to find a specific client's details, just call `get_customer`. This makes it perfect for nightly cron jobs.

Automate Tax Document Generation

Scripting complex invoicing is easy with this MCP Server. Write a shell script that calls `create_vat_invoice` and pipes the resulting document ID to an archiving system. It also handles creating simplified purchase invoices using `create_simplified_purchase` for automated expense logging.

Validate API Keys Headlessly

Before running any major script, you must validate credentials. Use the `validate_api_key` tool first. This function confirms your token works and isn't expired. You can also check system health using `check_simplefatoora_status`, making your CI/CD pipeline reliable.

Setup guide

Set up SimpleFatoora MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see simplefatoora-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest SimpleFatoora transactions." It will automatically discover and invoke the available SimpleFatoora tools.

Terminal

claude mcp add --transport http simplefatoora-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the SimpleFatoora MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "simplefatoora-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by SimpleFatoora. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect SimpleFatoora now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about SimpleFatoora MCP in Claude Code

You run the single command: `check_simplefatoora_status`. This confirms connectivity and API health without needing a GUI. It's ideal for pre-flight checks in automated pipelines.

The MCP Server offers full CRUD access. For scripting, focus on `list_invoices` to pull all necessary data into a CSV, or use `get_product` inside your loop to fetch current pricing.

Yes. You can automate product lifecycle management by calling `create_product` when a new service launches, or use `update_product` if the tax rate changes overnight.

It handles all standard compliance needs. Use `create_vat_invoice` for B2B transactions, or use `create_debit_note` when a payment adjustment is necessary. The server manages the required ZATCA structures.

This MCP Server interacts heavily with Transaction records (invoice IDs, amounts) and API Keys. It's critical that these tokens are secured when running scripts in a headless environment.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript