NuMetric

xyz.virifi.numetric-mcpPublished by numetric-mcp.virifi.xyzOfficial publisherv1.2.0Updated Oct 24, 2026

Read-only NuMetric.work accounting & ERP data: statements, KPIs, reports, invoices, documents.

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

A read-only remote connector to NuMetric.work accounting and ERP data, letting an assistant answer questions about statements, KPIs, invoices, projects and tax.

What you can do
Read the ledger: chart of accounts with balances, transaction search and detail, journal, financial statements, audit trail and change history, per-account reports, and net movement by month or quarter, plus KPIs and cash position. Review sales and payables: invoices, cash invoices, estimates, receivables and payables aging, bills, customers and customer subscriptions. Report on tax, projects and multi-project profit and loss, cashier sales and attendance, invoice sources, products and stock movement, and fixed assets with custody. Browse and download documents attached to records, including bundles as ZIP. Manage the session: list and select a business, and view your own NuMetric plan and,
When to use it
Use it when you want an assistant to answer questions from your actual NuMetric books, such as balance sheets, profit and loss, cash runway, overdue invoices, sales tax, project profitability or attached documents, without exporting data by hand.
Requirements
A remote Streamable-HTTP endpoint with OAuth 2.1 sign-in; no local package. A NuMetric.work account on any plan, your region, and an MCP client that supports remote servers with OAuth. Access follows your existing NuMetric permissions.
Before you install
Sign-in happens on NuMetric's own page; the assistant receives only a short-lived token, not your password. All tools are read-only and no write, payment or transfer tool exists. Figures marked Guarded may be stale or unbalanced and should be treated as unconfirmed. Reads are rate-limited and audit-logged, and document downloads return file contents.

Installation

In SourceWeft

  1. Open NuMetric in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/xyz.virifi.numetric-mcp%2Fnumetric/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "numetric": {
      "type": "http",
      "url": "https://numetric-mcp.virifi.xyz/mcp"
    }
  }
}

README

[NuMetric]

NuMetric MCP Server

Read your NuMetric accounting, reports & documents from any MCP client.

[MCP] [Auth] [Read-only] [License]

Website · Documentation · Privacy · Support

A Model Context Protocol server for the NuMetric.work POS / ERP / accounting platform. It exposes your live business data as read-only tools, so an AI assistant answers from your actual books instead of guessing.

It never creates, edits, or deletes anything.

https://numetric-mcp.virifi.xyz/mcp

What you can ask

  • "What's my balance sheet as of last month?" / "Show my P&L for Q2."
  • "What's my cash runway and current ratio?"
  • "List overdue invoices and total receivables."
  • "How much sales tax did I collect vs. pay this quarter?"
  • "Break down profit by project."
  • "Which customers subscribe to my monthly plan, and who cancelled?"
  • "What documents are attached to invoice INV-2026-0007?"

Install

Claude (web, Desktop, Code)

Settings → Connectors → Add custom connector → paste:

https://numetric-mcp.virifi.xyz/mcp

Then click Connect and sign in with your NuMetric email, password, and region. You're redirected back when authorized.

Claude Code (CLI)

bash
claude mcp add --transport http numetric https://numetric-mcp.virifi.xyz/mcp

Cursor / Windsurf / VS Code

json
{  "mcpServers": {    "numetric": {      "url": "https://numetric-mcp.virifi.xyz/mcp"    }  }}

Any other MCP client

Point it at the Streamable-HTTP endpoint above. The server advertises OAuth 2.1 discovery (RFC 9728 / RFC 8414), so compliant clients start the sign-in flow automatically.

Requirements

  • A NuMetric.work account (any plan).
  • Your region (e.g. JO, SA, or Global).
  • An MCP client that supports remote servers with OAuth.

Access follows your existing NuMetric permissions — you only ever see the modules you already have rights to. A tool you lack permission for returns SCOPE_REQUIRED rather than data.

Choosing a business

If your account has more than one business, ask your assistant to list your businesses, then select one ("list my businesses" → "use Acme Trading"). The choice sticks for the session and you can switch anytime. Single-business accounts are selected automatically.

Tools

Accounting spine (8)
ToolReturns
list_chart_of_accountsChart of accounts with live computed balances and classification. Balances are ledger-signed (debit − credit); each row carries magnitude/side/isNormalSide
search_transactionsLedger search by date, type, category, reviewed status
get_transactionOne transaction with its full journal lines
get_daily_transactionsThe general journal for a period (debits = credits)
get_financial_statementP&L, balance sheet, trial balance, cash flow
get_account_transactions_reportPer-account transaction detail for a period
get_audit_trailWho created or changed each transaction and when, with filters for date, category, type, reviewed status, creator, editor, project, amount and free text. Requires the audit-trail permission on your NuMetric account
get_transaction_activityThe change history of one transaction — every event with who made it, when, and which fields moved from what to what
Analysis & KPIs (3)
ToolReturns
get_kpisCash runway, current ratio, DSO, DPO, revenue concentration, unreviewed count
get_cash_positionCash and bank balances across accounts
get_net_movementPer-account net movement across a calendar year, by month or by quarter — how each account moved period over period rather than where it ended. Ledger-signed (debit − credit), so income and liability accounts move negative as they grow
Sales, receivables & payables (10)
ToolReturns
list_invoicesSales invoices with filters
list_cash_invoicesCash invoices with filters
list_estimatesQuotes / estimates
get_invoice_statusAR status of one invoice by id or number
get_receivablesAR aging with overdue confidence
list_billsPurchase bills
get_bill_statusAP status of one bill
get_payablesTotal owed plus AP aging. outstanding.outstandingTotal is what you owe; aging covers only the aged subset
list_customersCustomers, with duplicate detection
list_customer_subscriptionsSubscription plans you sell to your customers: each plan's price and billing frequency, subscriber counts (active / suspended / cancelled), who is subscribed, and what has been invoiced
Tax (2)
ToolReturns
get_sales_taxSales tax / VAT summary for a period
get_sales_tax_transactionsPer-transaction tax detail
Projects (2)
ToolReturns
list_projectsProjects with status
get_multi_project_profit_lossP&L across one or many projects
Retail & cashier reporting (5)
ToolReturns
list_cashiersCashiers / staff
get_cashier_sales_invoicesPer-cashier sales by invoice
get_cashier_sales_itemsPer-cashier sales by item
get_cashier_attendanceCashier attendance
get_invoice_source_reportSales grouped by invoice source
Inventory (3)
ToolReturns
list_productsProduct list, including low-stock filtering
get_item_summaryPer-item stock card / movement
get_source_quantity_reportQuantity by source
Fixed assets (2)
ToolReturns
get_asset_reportYour fixed-asset register — name, type, GL account, cost and depreciation rate — reconciled against NuMetric's depreciation schedule. Depreciation totals are reported only when the two cover the same assets, and withheld (null, never zero) when they do not
get_asset_custody_reportAsset custody by holder
Documents (4)
ToolReturns
get_storage_overviewDocument storage overview
list_documentsAttachments on invoices, bills, and other records
get_documentDownload one document's content
get_document_bundleDownload all documents on a record as a ZIP
Account & session (3)
ToolReturns
list_businessesBusinesses on your account
select_businessChoose which business to work on
get_subscriptionYour own NuMetric plan (what you pay NuMetric, not your customers' subscriptions) and what it includes: the plan you are on, your effective limits, how much of your transaction and seat allowance is left, who has access to the account, which capabilities are available, per-business feature toggles, and which tools your permissions allow

Machine-readable schema for every tool: mcp-schema.json.

Read-only by design

Every tool carries readOnlyHint: true. There is no payment, transfer, trade, create, edit, or delete tool in this server — not gated, not present. That is meant literally: as of 0.9.0 the write code was removed from the deployed server rather than left behind a feature flag, so there is no configuration that turns it on. Read-only tools run without per-call confirmation in clients that honor the hint.

Verified vs. Guarded

Every computed figure carries a confidence value:

  • Verified — the figure comes straight from NuMetric's accounting engine and reconciles.
  • Guarded — NuMetric flagged it as possibly stale or unbalanced, or it is a snapshot rather than a live read. Your subscription entitlements are always Guarded: NuMetric provides no way to re-read them, so they reflect the moment you connected and refresh when you reconnect. Usage figures are the exception worth knowing about — seat counts come from NuMetric directly, while the transaction count is measured from your ledger and is reported with its basis.

The server instructs connecting assistants to hedge on Guarded figures rather than present them as final. Claude reports what your books say; it does not recompute your accounting itself.

Authentication

OAuth 2.1 with PKCE (S256). You sign in on NuMetric's own page — your credentials are exchanged for a token server-side and held in an encrypted vault. The assistant only ever holds a short-lived token scoped to this server; your NuMetric password and API token never reach it.

Your business identity and region are bound to the authenticated principal and are never passed by the AI caller. Disconnect anytime from your client's connector settings.

Privacy & security

  • Read-only — no tool can move money or change your data.
  • Credentials never reach the AI client.
  • Encrypted in transit and at rest.
  • Every read is rate-limited per principal and written to an audit log.

See the Privacy Policy and Terms & Conditions.

Troubleshooting

MessageMeaning
NO_BUSINESS_SELECTEDRun "list my businesses", then select one.
SCOPE_REQUIREDYour NuMetric user lacks access to that module — ask your account admin.
A figure marked GuardedTreat it as unconfirmed rather than final.
STATEMENT_UNAVAILABLEThat statement type isn't available yet for your account.

Support

Via the in-app chat at help.numetric.work, or your usual NuMetric support channel.

About

Built and operated by VIRIFI Technologies Ltd (20–22 Wenlock Rd, London, UK), the maker of NuMetric. This is a first-party connector: NuMetric is our own platform and backend.

This repository holds the connector's public manifest and documentation. Licensed MIT.

Source: README.md at commit 4a60672

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

3
  1. v1.2.0LatestOct 17, 2026
  2. v1.1.0Sep 19, 2026
  3. v1.0.0Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts