How to Use the Simple Fatoora MCP in Windsurf

Q: How does Simple Fatoora help with VAT in Windsurf?

Windsurf's Cascade agent uses createvatinvoice to handle B2B billing. This tool automatically applies tax rates and embeds the required QR code, ensuring ZATCA compliance right out of the box.

Q: Can I list past Simple Fatoora invoices in Windsurf?

Sure thing. You just trigger listinvoices, and the agent pulls up a complete list for you. It shows the invoice ID, date, and status so you know exactly what needs attention.

Q: Does Simple Fatoora manage client data in Windsurf?

Yes. You can use getclient to look up any existing record or use updateclient if a contact changes their address. The MCP Server keeps your client directory accurate.

Q: If I need to check Simple Fatoora's product catalog in Windsurf, what tool do I use?

You should call listitems. This pulls up every product and service you've set up. It’s the easiest way to verify pricing before generating any invoices.

Automate ZATCA-compliant invoicing workflows directly within Windsurf's Cascade agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Simple Fatoora MCP to Windsurf

Create your Vinkius account to connect Simple Fatoora 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 Simple Fatoora with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Build and Validate Invoicing Workflows

Cascade handles the complex steps needed for tax compliance. Just give it a goal—like 'create an invoice for Client X'—and it uses `list_clients` first, then calls `get_client`, finally executing `create_vat_invoice`. It doesn't leave you hanging; it runs the whole sequence. This capability lets your agent manage both B2C and B2B invoicing. You can chain operations like creating a new client with `create_client` immediately followed by adding items using `list_items`, all without needing to write out every step.

Manage Client and Product Data

Need to prep the data before billing? Windsurf's agent manages client records. Use tools like `get_client` or `update_client` to make sure the contact info is current. You can also keep track of what you sell by listing products with `list_items`. If a client leaves, don't worry. The agent executes `delete_client`, keeping your billing records clean and accurate. It’s built for multi-step data hygiene.

Generate Compliant Tax Invoices

The core function is generating ZATCA-compliant invoices. You call `create_simplified_invoice` for B2C or `create_vat_invoice` for B2B. These tools automatically embed the necessary QR code and handle tax calculations. When you need to check what's already done, use `list_invoices` or `get_invoice`. It pulls up every detail—the item list, the client name, everything required by law.

Setup guide

Set up Simple Fatoora 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 Simple Fatoora 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 Simple Fatoora payment history." If connected, Cascade will call the Simple Fatoora tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "simple-fatoora-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 Simple Fatoora. 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 Simple Fatoora 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 Simple Fatoora MCP in Windsurf

Windsurf's Cascade agent uses `create_vat_invoice` to handle B2B billing. This tool automatically applies tax rates and embeds the required QR code, ensuring ZATCA compliance right out of the box.

Sure thing. You just trigger `list_invoices`, and the agent pulls up a complete list for you. It shows the invoice ID, date, and status so you know exactly what needs attention.

Yes. You can use `get_client` to look up any existing record or use `update_client` if a contact changes their address. The MCP Server keeps your client directory accurate.

You should call `list_items`. This pulls up every product and service you've set up. It’s the easiest way to verify pricing before generating any invoices.

This MCP Server handles client personal identification information (PII) and financial records, including tax IDs. You'll be interacting with structured billing and contact details when you use the tools.

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