Skip to main content

Revizo MCP server

Revizo has a built-in MCP server (Model Context Protocol) that lets AI agents such as Claude Desktop, Cursor and GitHub Copilot connect to Revizo and perform actions.

What is MCP?​

MCP is an open standard that lets AI models discover and use tools from external systems. With Revizo’s MCP server, an AI agent can:

  • See reconciliation status for all clients
  • Run Smart Match
  • Run control reports (accounts receivable, accounts payable, payroll)
  • Fetch trial balance from the accounting system via adapter (revizo_get_trial_balance) and transactions in Tripletex (bank lines)
  • Create vouchers and invoices in Tripletex
  • Search invoices, vouchers, general ledger postings and bank lines in Tripletex, search employees and departments, and approve supplier invoices
  • Manage tasks

Setup​

1. Generate an API key​

  1. Go to Settings → MCP API keys
  2. Click Create new key
  3. Give the key a name (for example «Claude Desktop»)
  4. Choose a role: Member (read + write) or Administrator
  5. Copy the key — it is shown only once

2. Connect the AI agent​

Add Revizo to the configuration for your AI agent. Example for Claude Desktop / Cursor:

{
"mcpServers": {
"revizo": {
"url": "https://app.revizo.ai/api/mcp",
"headers": {
"Authorization": "Bearer rvz_sk_din_nøkkel_her"
}
}
}
}

3. Start using it​

After connecting, you can talk to the AI agent about Revizo data:

«Show reconciliation status for all clients»

«Run Smart Match for client 1920 Bank deposits»

«What are the accounts receivable for Eksempel AS as of 31 March?»

Available tools​

Clients and reconciliation​

ToolDescription
revizo_list_clientsList of clients with reconciliation status
revizo_get_client_statusDetailed status for one client
revizo_get_unmatched_transactionsUnmatched transactions
revizo_search_transactionsSearch transactions

Companies​

ToolDescription
revizo_list_companiesList of companies with integration status
revizo_get_companyDetails for one company

Smart Match​

ToolDescription
revizo_preview_smart_matchPreview matching without saving
revizo_run_smart_matchRun and save Smart Match
revizo_get_matching_rulesShow matching rules for a client

Control reports​

ToolDescription
revizo_run_controlRun a control report (accounts receivable, accounts payable, payroll, accruals)
revizo_list_control_typesShow available control types

Accounting data​

ToolDescription
revizo_get_trial_balanceTrial balance from the accounting system
revizo_get_accounts_receivableAccounts receivable
revizo_get_accounts_payableAccounts payable

Tasks​

ToolDescription
revizo_list_tasksList of tasks
revizo_create_taskCreate a new task
revizo_update_task_statusUpdate task status

Tripletex actions​

ToolDescription
revizo_create_voucherCreate a voucher in Tripletex
revizo_create_invoiceCreate an invoice in Tripletex
revizo_search_tripletex_customersSearch for customers in Tripletex
revizo_search_tripletex_suppliersSearch for suppliers
revizo_search_tripletex_accountsSearch the chart of accounts
revizo_get_tripletex_vat_typesFetch VAT codes
revizo_search_tripletex_invoicesSearch outgoing customer invoices (period, pagination)
revizo_search_tripletex_supplier_invoicesSearch incoming supplier invoices
revizo_approve_tripletex_supplier_invoiceApprove a supplier invoice (requires write access)
revizo_search_tripletex_vouchersSearch vouchers in Tripletex
revizo_get_tripletex_ledger_postingsFetch postings from the general ledger
revizo_get_tripletex_bank_transactionsBank transactions for one account (accountId required)
revizo_search_tripletex_employeesSearch employees
revizo_search_tripletex_departmentsSearch departments (active)

Security​

  • API keys: Hashed with SHA-256, shown only at creation
  • Tenant isolation: Each key is tied to one organisation
  • Role-based access: The key inherits the role (a reader cannot run Smart Match)
  • Expiry: Set an optional expiry date on the key
  • Revocation: Keys can be revoked immediately under Settings

Managing keys​

Under Settings → MCP API keys you can:

  • See all active keys with prefix, role and last used
  • Create new keys
  • Revoke keys that should no longer be used

Example: Auditor with Claude Desktop​

Auditor: «Give me an overview of reconciliation status for all
clients in Eksempel AS»

Claude uses: revizo_list_clients(companyId: "...")
→ 24 clients: 20 fully reconciled, 3 with discrepancies, 1 not started

Claude: «Eksempel AS has 24 clients. 20 are fully reconciled.
3 have discrepancies:
- 1500 Accounts receivable: 15 unmatched (NOK 45,230)
- 1920 Bank deposits: 3 unmatched (NOK 12,100)
- 2400 Accounts payable: 1 unmatched (NOK 890)
Would you like me to run Smart Match on these?»

Auditor: «Yes, run Smart Match»

Claude uses: revizo_run_smart_match(clientId: "...")
→ 12 new matches, 6 remaining

Claude: «Smart Match completed. 12 transactions were matched.
6 remain for manual review.»