How to Use the SimpleFatoora MCP in Windsurf

Q: Can I list and update SimpleFatoora products in Windsurf?

Absolutely. You can use listproducts to see everything you have on file. If a price changed, just call updateproduct. The changes hit the system immediately, so your next invoice will reflect the new rates.

Q: What is the best way to manage SimpleFatoora users in Windsurf?

You'll use the customer tools. Start by calling createcustomer with the new user’s details. After they are set up, you can run listcustomers to verify that the account was added correctly.

Automate ZATCA-compliant invoicing and full ERP management using SimpleFatoora in Windsurf.

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 Windsurf

Create your Vinkius account to connect SimpleFatoora to Windsurf — 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Manage all document types

The `create_vat_invoice` tool handles complex B2B transactions, making sure your records comply with ZATCA tax rules. Your agent doesn't just create an invoice; it validates the necessary fields and calculates VAT across multiple product lines. Need something simpler? You can use `create_simplified_invoice` for quick B2C billing or run `create_standard_purchase` to record incoming goods, all within one autonomous workflow.

Handle customer and product data

`get_customer` fetches specific client details so your agent knows exactly who's paying. If a client doesn't exist, you can run `create_customer` first, keeping all records clean before processing any billing. Likewise, the `list_products` tool pulls current inventory data. You can then use `update_product` to adjust prices or descriptions right before generating an invoice.

Verify and delete records

Before committing a change, you must check connectivity using `check_simplefatoora_status`. It's a simple ping that confirms your connection to the SimpleFatoora MCP Server is active. When data gets messy, don't sweat it. You can use `delete_customer` or `delete_product` to clean up old records when they're no longer needed.

Setup guide

Set up SimpleFatoora MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my SimpleFatoora payment history." If connected, Cascade will call the SimpleFatoora tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "simplefatoora-mcp": {
      "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 Windsurf

Your agent sees the full process. You give it a goal—like 'Create an invoice for John Doe.' Cascade figures out that first, you need to check if the customer exists using `get_customer`. Then, it proceeds to call `create_vat_invoice` with all the necessary tax details.

Absolutely. You can use `list_products` to see everything you have on file. If a price changed, just call `update_product`. The changes hit the system immediately, so your next invoice will reflect the new rates.

SimpleFatoora handles critical accounting data: customer records (names, details), product catalogs, and all transactional documents like `create_vat_invoice` and credit notes. The system tracks every piece of information needed for ZATCA compliance.

You'll use the customer tools. Start by calling `create_customer` with the new user’s details. After they are set up, you can run `list_customers` to verify that the account was added correctly.

This MCP Server touches customer and product metadata. When using Windsurf, your agent handles these structured business records, ensuring you maintain control over who owns the data and how it's processed.

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