How to Use the SimpleFatoora MCP in Google ADK

Q: How do I use SimpleFatoora for B2B invoicing with Google ADK?

You call the createvatinvoice toolset. Your agent will pass the required VAT details and product list, ensuring the resulting document is fully compliant with ZATCA standards.

Q: Can SimpleFatoora track all transaction types using Google ADK?

Yes. You can generate B2C invoices via createsimplifiedinvoice, or process standard purchases with createstandardpurchase. The MCP Server handles the workflow for every document type.

Q: What is needed to run SimpleFatoora processes using Google ADK?

You must pass your API credentials first by calling validateapikey within your agent's toolset. This confirms the necessary access rights before any write operation occurs.

Q: How does SimpleFatoora handle product deletion? (Google ADK)

If a product is discontinued, you use deleteproduct. The agent will confirm that all associated invoices or records have been addressed before fully removing the item from the system.

Q: What data does SimpleFatoora touch when validating API keys?

The validateapikey function only checks your authentication token. It confirms connectivity and validity without accessing any customer, product, or invoice data.

Run SimpleFatoora e-invoicing processes directly from your Google ADK agents.

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 Google ADK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Process all document types using the MCP Server.

The server provides tools for every scenario. Generate a formal B2B VAT invoice with `create_vat_invoice`, or handle smaller sales through `create_simplified_invoice`. If you need to correct an amount, simply use `create_credit_note`. The agent handles the complexities of ZATCA compliance across all types. Your big data queries can then feed directly into these transactions. You'll find that document generation is highly predictable when using the structured calls provided by this MCP Server.

Query and update SimpleFatoora product catalogs.

You don't need to leave Google Cloud to manage inventory data. Use `list_products` to pull a full catalog view, or use `get_product` for specific item details. Need an update? Running `update_product` changes the record directly within SimpleFatoora. This lets your agent act on operational data stored in BigQuery and then synchronize those changes back into core e-invoicing records.

Manage customer data with high fidelity.

Building a robust pipeline starts with clean client data. Use `list_customers` to retrieve all accounts, or `get_customer` for deep profiles. If an account is outdated, you can run `update_customer`. For cleanup tasks, `delete_customer` handles removal. The agent ensures the customer record matches what your users expect, whether they're viewing data in Vertex AI or running a transaction.

Setup guide

Set up SimpleFatoora MCP in Google ADK

Prerequisites

Python 3.10+ installed
google-adk package (pip install google-adk)
Active Vinkius subscription with a valid endpoint token

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with SimpleFatoora tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="SimpleFatoora_agent",
    model="gemini-2.0-flash",
    instruction="You have access to SimpleFatoora tools via MCP.",
    tools=mcp_tools,
)

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 Google ADK

You call the `create_vat_invoice` toolset. Your agent will pass the required VAT details and product list, ensuring the resulting document is fully compliant with ZATCA standards.

Yes. You can generate B2C invoices via `create_simplified_invoice`, or process standard purchases with `create_standard_purchase`. The MCP Server handles the workflow for every document type.

You must pass your API credentials first by calling `validate_api_key` within your agent's toolset. This confirms the necessary access rights before any write operation occurs.

If a product is discontinued, you use `delete_product`. The agent will confirm that all associated invoices or records have been addressed before fully removing the item from the system.

The `validate_api_key` function only checks your authentication token. It confirms connectivity and validity without accessing any customer, product, or invoice data.

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