See AI agents and MCP for how to connect and how approval works.
What MCP gives you
The Model Context Protocol is an open standard for connecting AI applications to tools and data. With an MCP server, any compatible assistant or agent framework can work with WonderFatoora without custom integration code.
Tools
| Group | Tools |
|---|---|
| Company | get_company_profile, get_integration_status |
| Customers | search_customers, get_customer, create_customer, update_customer |
| Products and services | search_products, get_product, create_product, update_product |
| Invoices and notes | list_invoices, get_invoice, get_invoice_status, list_invoice_notes, get_note, create_invoice_draft, validate_invoice_draft, create_note_draft |
| Payments | record_payment, list_invoice_payments |
| Projects | list_projects, get_project_summary, set_invoice_project |
| Documents | get_document_download_link: a PDF link valid for five minutes |
| Irreversible (off by default) | issue_invoice, issue_note, create_credit_note, create_debit_note: every call needs a person's approval in WonderFatoora |
How approval works
- The agent asks to issue. WonderFatoora checks the draft and records a pending approval tied to that company, connection, person and exact document.
- The agent receives a link and shows it to the person.
- The person signs in, confirms their password, sees the document as stored in WonderFatoora, and approves or denies it.
- Only then does the agent's retry issue it, once, and only if the draft has not changed since it was approved.
Connection and security
- A remote server over Streamable HTTP at
https://fatoora.tw.sa/mcp, speaking MCP2026-07-28,2025-11-25and2025-06-18without sessions. - OAuth 2.1 with PKCE: the company chooses which scopes to grant, and can revoke them.
- Tokens are bound to the MCP server and never forwarded elsewhere.
- Results from a sandbox company are always labelled as such.
Ready to build?
API access is part of the Business and Enterprise plans. Create a key in Settings → API keys and make your first call in minutes.