What is Trivis MCP?
Accounting you can talk to
Trivis MCP is a remote Model Context Protocol server built into Trivis. It exposes your organisation's accounting data as tools that any MCP-compatible AI assistant can call: reading reports, creating invoices, recording payments, and more.
Unlike screen-scraping or CSV exports, Trivis MCP gives the AI assistant live, structured access to your data. Write operations that could affect your books (confirming invoices, closing periods) require explicit approval from an administrator, so you stay in control.
Setup
Connect your AI assistant
Claude.ai
Connect via OAuth
Best for Claude.ai web. No API key needed, you authenticate with your Trivis account.
- 1Open Claude.ai connectorsSettings → Connectors → Add custom connector
- 2Enter the server URL
https://ai-api.trivis.ee/mcp - 3Authorise in TrivisYou'll be redirected to login.trivis.ee. Choose read-only or read & write access.
Claude Code CLI
Connect via API key
Best for Claude Code, Cursor, or any HTTP MCP client. Create a key in Trivis settings.
- 1Create an API keyIn Trivis: Settings → Developer → MCP keys. Copy it, shown once only.
- 2Add to your config
{
"mcpServers": {
"trivis": {
"url": "https://ai-api.trivis.ee/mcp",
"headers": {
"Authorization": "Bearer trivismcp_live_..."
}
}
}
}
Add to ~/.claude/settings.json (Claude Code) or your client's MCP config.
Capabilities
Available tools
Tools are automatically filtered by your access scope. Read-only keys see only read tools; write keys see all tools. Write operations marked approval create a pending request in Trivis that an admin must confirm before execution.
- list_invoices
- get_invoice
- create_invoice
- update_invoice
- add / update / delete_invoice_row
- confirm_invoice approval
- cancel_invoice approval
- list_purchase_invoices
- get_purchase_invoice
- create_purchase_import
- confirm_purchase_invoice
- add / update / delete_purchase_invoice_row
- list_import_jobs
- get_import_job
- confirm_import_accounts
- refresh_supplier_snapshot
- list_ledger_entries
- get_trial_balance
- get_account_balance
- list_accounts
- list_periods / fiscal_years / quarters
- list_tax_rates / get_tax_rate
- create_ledger_entry
- confirm_ledger_entry
- create / open / close / lock_period
- create_fiscal_year · create_quarter
- update_period_metadata
- record_payment approval
- list_contacts
- get_contact
- create_contact
- update_contact
- get_deals · add_deal · update_deal
- get_interactions · add_interaction
- get_tasks
- search_tasks
- add_task
- update_task
- complete_task
- archive_task
- get_ar_summary
- get_ap_summary
- get_overdue_invoices
- get_revenue_summary
- get_cashflow_forecast
- parse_bank_statement
- parse_annual_report
- get_revenue_by_activity
- db_query unsafe
- get_delivery_options
- send_invoice_email approval
- send_invoice_einvoice approval
- batch_send_invoices approval
- send_email approval
- list_tables
- get_table_records
- create_table_record
- update_table_record
- delete_table_record
- search_economic_activity_codes
- assign_category_activity_code
- get_revenue_by_activity
- search_similar
- search_knowledge
- get_organization_profile
- update_organization_profile
- list_banks / list_bank_types
- create_bank · create_iban
- get_datetime
approval = requires admin approval in Trivis before execution.
Permissions
Access scopes
When you connect via OAuth, you choose a scope. API keys are assigned a scope at creation time.
| Scope | Access | Use case |
|---|---|---|
mcp:read |
Read only. Lists, lookups, analytics, and search. No data is created or modified. | Dashboards, reporting, querying overdue invoices, checking cashflow |
mcp:write |
Read + write. Includes all read tools plus creating invoices, contacts, payments, etc. Destructive operations require an explicit admin approval in Trivis. | Full accounting assistant: import invoices, create contacts, record payments |
mcp:write:unsafe |
Read + write + raw SQL. Includes all write tools plus db_query: a direct SELECT query against the tenant database. No approval gate. |
Developers, data analysis, custom reporting |
Your organisation role
The scope above is the ceiling; your actual reach is also bounded by your role in the organisation. Trivis tracks read and manipulate rights separately across twelve services (AI, audit, contracts, CRM, invoices, ledger, payments, products, purchase, reports, settings, tables), and your role decides which ones you get. Tools are filtered to the intersection of your scope and your role, so a write-scoped key held by a sales user still cannot touch the ledger.
| Role | Access |
|---|---|
| Owner · Admin · Member | Full. Read and manipulate across all twelve services. |
| Accountant | Books. Manipulate AI, invoices, ledger, payments, and purchase; read audit, contracts, reports, settings, and tables. No CRM or products. |
| Sales | Front office. Manipulate AI, CRM, contracts, and invoices; read products and reports. No ledger, payments, or purchase. |
| Viewer | Read only. Read across every service, write nowhere, regardless of scope. |
Example prompts
What you can ask
These prompts work out of the box once you've connected Trivis to your AI assistant.
Show me all overdue customer invoices and the total outstanding amount.
Fetches confirmed invoices past their due date, sorted by age, with totals. Good for a quick accounts-receivable health check.
get_overdue_invoicesget_ar_summaryCreate a sales invoice for Acme Corp for software consulting, 2 500 EUR, 20 % VAT, 30-day payment terms. Add one row.
Looks up or creates the Acme contact, creates a draft invoice, adds the row with the correct tax rate, and confirms it's ready for review.
list_contactscreate_invoiceadd_invoice_rowlist_tax_ratesWhat's my cash position? How much do customers owe me versus how much do I owe suppliers?
Pulls live AR and AP summaries including overdue buckets and amounts due in the next 30 days. Also runs a 60-day cashflow forecast.
get_ar_summaryget_ap_summaryget_cashflow_forecastImport this purchase invoice from the supplier: [paste invoice text or OCR output]
Creates an import job, waits for AI extraction to complete, automatically assigns expense accounts by word-overlap matching, and returns the fully processed invoice ready to confirm.
create_purchase_importShow me my monthly revenue trend for the last 6 months.
Returns a month-by-month breakdown of confirmed sales invoice totals. Useful for spotting seasonal patterns or growth trends.
get_revenue_summaryMark invoice #1042 as paid, payment received 2026-05-10, amount 1 850 EUR from main bank account.
Creates a posted payment, allocates it to the invoice, and marks the invoice as paid: all in one step. Requires admin approval before execution.
get_invoicelist_accountsrecord_paymentSend all confirmed unpaid invoices from this month to customers by email.
Checks token balance, finds the matching invoices, and dispatches them all in one call. Returns a per-invoice success/failure result. Requires admin approval before execution.
list_invoicesget_delivery_optionsbatch_send_invoicesSend a notice about our new prices starting July 1st to all customers who have purchased item X but haven't received a sales invoice in the last 6 months.
Finds the unique contact list from open invoices, drafts a personalised email from your org profile, and sends it, without you hunting for anyone's address manually. Requires admin approval before execution.
list_invoicesget_contactsend_emailSupport
Need help?
Email support
401 Unauthorized
Your token expired. Re-authenticate in Claude.ai → Settings → Connectors, or create a new API key in Trivis.
Tool not available
Your key may lack the required scope. Check Settings → Developer → MCP keys in Trivis and create a write-scoped key if needed.
Awaiting approval
Write operations that affect your books need admin approval. Check pending approvals in Trivis AI settings.