# com.aurgus/aurgus (remote · mcp.aurgus.com)

Governed rebate & revenue close (ASC 606/705/842): explain, ingest, compute, trace to source.

- Trust score: 67/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `mcp.aurgus.com`: 67/100 (this document), [markdown](https://verifymcp.io/servers/com-aurgus-aurgus/api-mcp.md), [page](https://verifymcp.io/servers/com-aurgus-aurgus/api-mcp)

## Channel facts

- Endpoint: `https://mcp.aurgus.com/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (defunct_agreement).
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 77/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 9553 tokens (~251/item across 38 items; 38 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 13/100
  - Stability observed for 4 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 38 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 39 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the com.aurgus/aurgus MCP server?

com.aurgus/aurgus is a hosted endpoint at https://mcp.aurgus.com/api/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http com-aurgus-aurgus 'https://mcp.aurgus.com/api/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "com-aurgus-aurgus": {
      "url": "https://mcp.aurgus.com/api/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "com-aurgus-aurgus": {
      "type": "http",
      "url": "https://mcp.aurgus.com/api/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.com-aurgus-aurgus]
url = "https://mcp.aurgus.com/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-aurgus-aurgus": {
      "type": "remote",
      "url": "https://mcp.aurgus.com/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-aurgus-aurgus --url 'https://mcp.aurgus.com/api/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-aurgus-aurgus:
    url: "https://mcp.aurgus.com/api/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "com-aurgus-aurgus": {
      "Transport": "http",
      "Url": "https://mcp.aurgus.com/api/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add com-aurgus-aurgus -t streamable-http -u 'https://mcp.aurgus.com/api/mcp'
```

### Other

```json
{
  "mcpServers": {
    "com-aurgus-aurgus": {
      "type": "http",
      "url": "https://mcp.aurgus.com/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-04 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-02 (score 66, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-11-01 (score 65)

First indexed and scored.

## MCP tools (38)

### `begin` (~132 tokens)

Call this the moment the user greets Aurgus or wants to start — 'Aurgus, hi', 'hello', 'hey Aurgus', 'let's start', 'I want to run a close', 'where do I begin'. Aurgus introduces itself as the client's independent revenue-management controller and LEADS into the engagement, asking who the client is, the period, and what's being closed. Free, no account needed, computes nothing — the next step is open_engagement.

Input parameters:

- `scenario` (string): Optional: what the user wants to close, if they said (woven into the greeting).

### `help` (~98 tokens)

Call this when the user asks for help or how to use Aurgus — 'Aurgus help', 'help', 'what can you do', 'how do I use this', 'show me the manual', 'what are the commands / trigger words'. Returns the Aurgus manual: what it is, how an engagement runs step by step, the trigger phrases that fire each tool, and how to start. Free, no account needed.

### `release_notes` (~96 tokens)

What's new in Aurgus and how to stress-test it — call this for 'what changed', 'release notes', 'what's new', 'changelog', or if you're reviewing/pressure-testing the product. Returns the current release summary (reuse-first institutional knowledge, document/PDF intake, the anti-hallucination guards, ASC coverage) plus a concrete test checklist. Free, no account needed, reads nothing from any tenant.

### `explain` (~417 tokens)

State the governed US-GAAP treatment FOR A PAYMENT TYPE — a rebate, incentive, chargeback, or trade-spend payment — under ASC 606 (customer rebate / consideration payable to a customer / variable consideration), ASC 705-20 (vendor rebate), or ASC 340-40 (sales commission). It CLASSIFIES the payment and returns the governed treatment, the exact ASC citation, and the rule applied — deterministic and grounded, it will not guess and asks which payment type applies when unclear. It is NOT a free-form accounting Q&A or advisory debate: it does not argue a position, weigh a contrary opinion, or answer open questions beyond the payment-type classification (the `scenario` text is context only). For anything past the treatment of a payment type, run the engagement (compose/ingest the agreement, then compute).

Input parameters:

- `buys_distinct_good_or_service` (boolean): True if the payment is in exchange for a distinct good or service the counterparty actually transfers (e.g. advertising, data, slotting with proof-of-performance), as opposed to a plain price concess…
- `fair_value_cap_usd` (number): Required only when buys_distinct_good_or_service is true: the fair value of that distinct good/service. The payment is a purchase only up to fair value; any excess reverts to the default treatment.
- `payment` (string): The nature of the payment. customer_rebate = you pay/credit your customer (sell side); spa_or_billback = a special pricing agreement / billback credit to the customer; chargeback = a channel chargeba…
- `scenario` (string): Optional free-text description of the user's scenario, for context.

### `request_real_run` (~141 tokens)

Get the link to run a real close on your OWN numbers — bring a rebate / SPA / deduction extract and get back audit-defensible accruals, full lineage, and an auditor-ready export, with nothing posted to your GL. Use this when the user is ready to move from a sample to their own data. Optionally takes a work email to set up access — only what the user volunteers, and never ask for financial data inside the chat.

Input parameters:

- `email` (string): Optional work email to set up access / follow up. Only pass what the user volunteers.
- `scenario` (string): Optional short description of what the user wants to run.

### `aurgus` (~402 tokens)

THE one way to talk to Aurgus — the client's revenue-management controller. For ANYTHING the user says to Aurgus (a greeting, 'close Q3', 'where are we', 'what do you need from me'), call THIS with their message rather than picking a specific tool; Aurgus reads the engagement's real state, leads like a firm, and tells you the single next step. Pass entity/period/program when the user has named them (so Aurgus can open the engagement), and engagement_id once one is open. The specialized tools (ingest, compute_close, sign_close, …) are the controller's hands — reach for one only when Aurgus's reply tells you to (e.g. to ingest a CSV, compute with numbers, or sign). Free to greet; a real run on the user's data needs a connected account.

Input parameters:

- `direction` (string): Which side the client is on for a billback / chargeback / rebate: 'paying' (sell-side → ASC 606, reduces revenue) or 'receiving' (buy-side → ASC 705-20, reduces cost of sales). Pass it once the user…
- `engagement_id` (string): The current engagement, once one is open.
- `entity` (string): The client entity, when the user has named who they're closing for.
- `message` (string): What the user said to Aurgus, verbatim.
- `period` (string): The close period, when named (e.g. 'Q3 2026').
- `program` (string): The program being closed, when named (e.g. 'tiered volume rebate').
- `who_certifies` (string): Who will certify the terms + mapping (name or email), when the user has named them — captured at open so the certifier is on the engagement from the start.

### `open_engagement` (~261 tokens)

Open a revenue-management engagement for a client. Capture the intake — the client entity, the period, the program(s), the sources of truth, and who will certify — and start the engagement file (a hash-chained, append-only record of everything that follows). This is how a firm begins: a named client and a scope, before any numbers. The agreement comes next; nothing is computed here.

Input parameters:

- `direction` (string): Which side the client is on for a billback / chargeback / rebate: 'paying' (sell-side → ASC 606) or 'receiving' (buy-side → ASC 705-20). Omit if not yet known — Aurgus will ask rather than assume the…
- `entity` (string, required): The client entity we're closing for (e.g. 'Acme Distribution').
- `period` (string): The close period (e.g. 'Q3 2026').
- `programs` (array): The rebate / SPA / billback program(s) in scope, if known.
- `sources_of_truth` (array): The client's systems of record for this close.
- `who_certifies` (string): Who on the client side will certify the terms and mapping (name or email).

### `engagement_status` (~122 tokens)

Report where an engagement stands — derived from the engagement file's real events, not a stored status. With an engagement id, it shows which steps are on the chain, what's next, and any open items (the close can't be signed while any remain). With no id, it lists the client's engagements and the firm's own status. If the file's hash chain fails re-verification it refuses to report rather than vouch for a tampered record.

Input parameters:

- `engagement_id` (string): The engagement to report on. Omit to list all engagements + the firm status.

### `request_documents` (~118 tokens)

Draft the PBC (prepared-by-client) document list for an engagement, FROM its agreement — the program decides which files the close needs (a sell-side rebate → the POS / sell-through extract; a buy-side billback → the claims file), never a generic ask. Each requested document is logged as an open item; the close can't be signed until every one is received, mapped and certified. Needs an active agreement first (the agreement is the rulebook).

Input parameters:

- `engagement_id` (string, required): The engagement to draft the PBC list for.

### `open_items` (~169 tokens)

The engagement's open-items register — the things the close can't yet account for (a document not received, a term not found in the agreement, an unmatched figure). List them, open a new one, or resolve one by id. The register ships alongside the certified figures; no gap is ever filled on the client's behalf, and the close cannot be signed while any item remains open.

Input parameters:

- `action` (string): list (default), open a new item, or resolve one.
- `engagement_id` (string, required): The engagement whose register to act on.
- `item` (string): For action=open: the open item's description.
- `item_id` (string): For action=resolve: the id of the item being resolved.
- `owner` (string): For action=open: who owns resolving it.

### `receive_document` (~223 tokens)

Receive a client document into an engagement BY REFERENCE — a client-granted signed https link (or an upload handle), never the file's contents. The engine fetches it server-side, stages it inside the client's tenant for certification, and tells you only the column names and where to certify the mapping — no row of the client's data ever passes through the model. Resolves the matching PBC open item. This is how the data gets in without it ever touching the model: 'no LLM on the money path' stays literally true.

Input parameters:

- `engagement_id` (string, required): The engagement this document belongs to.
- `kind` (string, required): Which stream this is (pos = sell-through, claims = billbacks, credits = credit memos).
- `signed_url` (string): A client-granted signed https link to the file (e.g. a Drive/SharePoint export). The engine fetches it directly; you do NOT paste the file contents.
- `upload_handle` (string): Alternatively, a handle to a file already uploaded to the client's tenant store.

### `compute_commission` (~436 tokens)

Compute a sales-commission engagement under ASC 340-40 (incremental cost to obtain a contract). Give the commission amount, the benefit period it amortizes over, and how many months have elapsed; it classifies the cost, then capitalizes a recoverable commission and amortizes it straight-line — returning the capitalized asset, amortization to date, the period expense, and the net carrying amount. This is a capitalized asset and an amortization schedule, NOT revenue. It refuses (asks) if recoverability or the amount is unclear. The result is recorded on the engagement file; a principal signs before the workpapers are delivered.

Input parameters:

- `benefit_months` (number, required): The benefit period over which it amortizes, in months.
- `commission_usd` (number, required): The commission — the incremental cost to obtain the contract.
- `contract_terminated` (boolean): Set true if the underlying contract was TERMINATED early. The remaining capitalized asset can't simply finish amortizing — it triggers an ASC 340-40-35-3 impairment assessment, raised as an open item…
- `elect_practical_expedient` (boolean): Set true ONLY if the entity has ELECTED the ≤1-year practical expedient (340-40-25-4) to expense a commission that amortizes within a year. Omit/false → a ≤12-month commission CAPITALIZES (25-1); the…
- `engagement_id` (string, required): The commission engagement (opened via open_engagement, classified as a commission).
- `expected_to_be_recovered` (boolean): Whether the cost is expected to be recovered (340-40-25-1). Omit if unknown and it will ask.
- `months_elapsed` (number, required): Months elapsed into the benefit period at this close.
- `remaining_consideration_usd` (number): On a terminated contract, the consideration the entity still expects to receive (340-40-35-3(a)). Omit if none/unknown and the full carrying amount is flagged for impairment review.

### `compute_revenue_contract` (~171 tokens)

Run the full ASC 606 five-step recognition for a general revenue contract: identify the performance obligations (Step 2), allocate the transaction price by standalone selling price (Step 4), and recognize over time or at a point in time (Step 5). Give the transaction price and the promised items (each with its standalone selling price). Whatever the engine can't determine from what you provide — distinctness, timing — it logs as an OPEN ITEM rather than guessing. The result is recorded on the engagement file; a principal signs before the workpapers are delivered.

Input parameters:

- `engagement_id` (string, required): The revenue-contract engagement (opened + classified as a general revenue contract).
- `items` (array, required): The promised items in the contract.
- `transaction_price_usd` (number, required): The contract's transaction price.

### `compute_lease` (~453 tokens)

Measure a lease under ASC 842 (v1: the lessee side — real estate and equipment). Give the term, the CERTIFIED discount rate (the rate implicit in the lease, or the incremental borrowing rate — it will NOT assume one), and the payment schedule; it measures the lease liability (present value of the payments), the right-of-use asset (liability + initial direct costs − incentives), and the amortization schedule — a single straight-line lease cost for an operating lease (842-20-25-6) or amortization + interest for a finance lease (842-20-25-5). Usage-based variable payments are excluded from the liability (842-10-30-6). Whatever it can't ground — a missing rate, an undetermined classification — it logs as an OPEN ITEM rather than guessing; lessor accounting is deferred. The result is recorded on the engagement file; a principal signs before the workpapers are delivered.

Input parameters:

- `annual_discount_rate_pct` (number, required): The CERTIFIED annual discount rate (%). Omit and it will ask — it never assumes a rate.
- `classification` (string): The certified classification. Omit to default to operating (the v1 real-estate wedge).
- `engagement_id` (string, required): The lease engagement (opened via open_engagement, classified as a lease).
- `incentives_usd` (number): Lease incentives received (e.g. a tenant-improvement allowance) — reduces the ROU asset.
- `initial_direct_costs_usd` (number): Initial direct costs — added to the ROU asset.
- `party` (string): v1 is lessee-only; a lessor request is deferred to v2.
- `payment_timing` (string): Whether payments fall at period end (arrears, default) or start (advance).
- `payments` (array, required): The lease payment schedule.
- `periods_per_year` (number): Periods per year: 12 monthly (default), 4 quarterly, 1 annual.
- `prepaid_usd` (number): Payments made at or before commencement — added to the ROU asset.
- `term_periods` (number, required): The lease term as a number of periods.

### `compute_trade_spend` (~251 tokens)

Split a trade-spend payment to a customer (co-op advertising, MDF, slotting, listing allowance) under ASC 606-10-32-26 / 705-20-25-2. If the payment buys a DISTINCT good or service the customer actually provides (e.g. advertising with proof-of-performance), it's a purchase/expense UP TO that good's fair value; any EXCESS over fair value reduces revenue. Give the payment amount, whether it buys a distinct good/service, and that good's fair value — it returns the expense leg and the revenue-reduction leg. It refuses (asks) for the fair value rather than guess; if it buys nothing distinct, the whole payment reduces revenue (no split). Nothing posts; a principal signs the close.

Input parameters:

- `buys_distinct_good_or_service` (boolean): True if the customer transfers a distinct good/service (e.g. advertising with proof-of-performance). False → the whole payment reduces revenue (no split).
- `fair_value_usd` (number): Fair value of that distinct good/service. Required to split; omit and it will ask.
- `payment_usd` (number, required): The trade-spend payment to the customer.

### `sign_close` (~85 tokens)

A principal signs the governed close for an engagement, by name, on the engagement file. It refuses while any open item remains — the open-items register gates the signature — and a close must have been computed. You cannot sign on the client's behalf; the person signs. Signing is what releases the workpapers.

Input parameters:

- `engagement_id` (string, required): The engagement whose close is being signed.

### `export_workpapers` (~81 tokens)

Deliver the engagement workpapers — the certified figures and the open-items register on one page, from the hash-chained engagement file. Refuses until a principal has signed the close. This is the auditor-ready deliverable: what was concluded, and what could not be proven, together.

Input parameters:

- `engagement_id` (string, required): The engagement to deliver workpapers for.

### `ingest_agreement` (~260 tokens)

Hand Aurgus your rebate agreement — PASTE its text, or DROP a PDF/scanned document (pass it as file_base64). Aurgus reads the terms with its deterministic parser (and CV/OCR for a PDF/scan — a Python CPU service, ZERO LLM): customer, basis (whole-volume / incremental / cliff), rate or tier ladder, and the rebate period. A CPU parser proposes spans, deterministic rules produce every value, and anything it can't read cleanly is flagged for your eye rather than guessed. Nothing is created until a person reviews and certifies the terms in the browser — this is how the agreement (and the ASC 606 treatment it implies) gets set up, before any transaction data is asked for.

Input parameters:

- `file_base64` (string): A PDF or scanned-image agreement, base64-encoded. Aurgus reads it with CV/OCR (zero LLM). Provide this OR text.
- `filename` (string): The original filename (e.g. 'rebate-agreement.pdf') — used to sniff the file type and shown on the review page.
- `text` (string): The agreement's text (paste the full agreement, or the rebate clauses). Provide this OR file_base64.

### `compose_agreement` (~370 tokens)

Build a rebate/incentive agreement by talking it through — no document needed. Describe the program in plain words and Aurgus DRAFTS the terms (who qualifies, how volume is measured and over what period, the threshold, the rate or per-unit reward, any cap, and approval routing) and asks the consultant-style questions a controller would ask before assuming. IMPORTANT: these terms are DRAFTED by the model from your words — they are PROPOSED, NOT PARSED, and nothing is created. When the terms are right, call again with finalize=true and the reviewed proposal, and Aurgus stages it for a person with approval authority to approve in the browser (you can NOT approve your own). This is how you establish an agreement (ASC 606 step 1) when you have no document — before any transaction data is asked for. When a document exists, prefer ingest_agreement (its deterministic parser touches the numbers with zero LLM).

Input parameters:

- `clarifications` (array): Answers to the follow-up questions from a previous turn, so the draft refines. Each item pairs the question asked with the answer.
- `description` (string, required): Plain-language description of the program — who it's for, how it's measured and over what period, the rate/threshold/cap, the dates. On the first turn, just describe it.
- `finalize` (boolean): Set true ONLY after the terms have been reviewed and the follow-ups resolved. Stages the proposal for human approval; omit/false to just draft and refine.
- `proposal` (object): Required when finalize=true: the EXACT drafted proposal returned by a prior (non-finalize) call, echoed back verbatim — so what is staged is exactly what was reviewed. Staging does NOT re-run the mod…

### `ingest` (~324 tokens)

Hand Aurgus one of your three rebate files (CSV) to read into your tenant: 'pos' (your POS / sell-through extract — what was earned), 'claims' (the claims you submitted), or 'credits' (credit memos / vendor invoices you received). Give it the raw CSV, which kind of file it is, and a note of which of your columns maps to which Aurgus field. Rows with blank or bad amounts are held and reported back to you — never quietly booked as $0 — and nothing touches your numbers until a person certifies the mapping. Requires a connected Aurgus account.

Input parameters:

- `csv` (string, required): The raw CSV content of your extract (header row + data rows).
- `filename` (string): Optional original filename.
- `kind` (string): Which file this is: 'pos' (sales/POS extract — earned), 'claims' (claims submitted), or 'credits' (credit memos / vendor invoices received). Defaults to 'pos'.
- `mapping` (object, required): Map each of your column headers to an Aurgus field. pos fields: source_transaction_id, transaction_at, end_customer_id, material_id, amount_usd, distributor_id, quantity. claims fields: source_claim_…

### `compute_close` (~145 tokens)

The RUN step (step 6) of an open engagement — work the governed, deterministic earned → settled → open accrual across the engagement's active agreements and certified data. Do NOT call this as the first thing when a user says 'compute the close': a firm opens the engagement first (open_engagement), establishes the agreement, requests + certifies the data, and only then runs. If no engagement is open, this refuses and leads back to open_engagement. You get back the number, how earned / claimed / credited line up, and any flag worth raising. Nothing posts to the GL; the number is prepared for approval. Requires a connected Aurgus account.

### `confirm_grouping` (~320 tokens)

Record the human's answer to a customer-grouping question Aurgus asked — a grouping compute_close PROPOSED ('GPG LLC resembles Global Procurement Group LLC', or 'these are the GPO's members'), OR a change to a roster Aurgus already knows ('did anything change?' → a new member joined, or one left). Aurgus never changes a group on its own — this tool is the person's approval, and what makes Aurgus remember. Added names become DATE-CONTROLLED members of the agreement's customer scope so the NEXT close matches them automatically; removing a member ENDS its membership as-of a date (never deletes — its past purchases stay attributed, only later ones stop rolling up). Use ONLY after Aurgus surfaced the question and the user answered; pass the agreement_id and the name(s) exactly as they appear in the data. Set valid_from/valid_to for a real join/leave date (a GPO join, an acquisition, a rename, a member leaving); omit valid_from for open-ended. After confirming, run compute_close again to fold the change in.

Input parameters:

- `agreement_id` (string, required): The agreement whose customer scope this concerns — from the compute_close proposal or roster.
- `ended_members` (array): Member(s) that LEFT the group — their membership is ended as-of valid_to (not deleted; prior purchases stay attributed).
- `members` (array): Name(s) the user confirmed BELONG to this agreement (added as members), exactly as they appear in the data.

### `report` (~158 tokens)

The portfolio report — every active agreement on the tenant (or one, by id), with its earned / settled / open accrual, basis, status, and when it last calculated. This is the book-at-a-glance a controller watches: which agreements are live, what each has earned vs paid out, and what is open. Pass agreement_id for a single agreement, or status to filter the list (active / draft / closed / superseded). Read-only — it computes nothing new, it reports the canonical ledger. Requires a connected Aurgus account.

Input parameters:

- `agreement_id` (string): Report on ONE agreement by id. Omit for the whole book.
- `status` (string): Filter the list by lifecycle status. Default: active.

### `set_cadence` (~275 tokens)

Set how often an agreement ACCRUES and SETTLES. Ask the user these when setting an agreement up (or to change them later): (1) how often to accrue — 'realtime' as sales land, or batched 'daily' / 'weekly' / 'monthly' / 'per_event'; (2) how often it settles — when the money actually hits their account — 'weekly', 'semi_monthly', 'monthly', 'quarterly', 'semi_annual', 'annual', 'threshold' (when a dollar threshold is hit), or 'ad_hoc'. Pass the agreement_id and whichever cadence(s) the user chose; you can set one or both. Requires a connected Aurgus account.

Input parameters:

- `accrual_cadence` (string): How often to accrue. 'realtime' = as each sale lands.
- `agreement_id` (string, required): The agreement whose cadence to set.
- `settlement_approver_email` (string): If someone must APPROVE each settlement before money moves, their email. Aurgus holds every settlement and emails them a one-time confirm link; nothing settles until they approve. Pass an empty strin…
- `settlement_cadence` (string): How often it settles — when the rebate is actually paid out.

### `close_agreement` (~256 tokens)

Close an agreement for good — the terminal true-up at the END of its life (its term ended, or it's being wound down). Closing posts a final true-up Adjustment that matches the accrual to the settled amount (open → $0), THEN FREEZES the agreement: it moves to 'closed' and NO new transactions ever calculate against it again. This is NOT the periodic run (compute_close) or the periodic payout (settlement) — it ends the agreement. Because it MOVES MONEY (the true-up Adjustment), call WITHOUT confirm first to DRY-RUN — it reports the adjustment that would post and that the agreement will be frozen. Call again with confirm:true to post it and close. Terminal. Needs the agreement_id. Requires a connected Aurgus account.

Input parameters:

- `agreement_id` (string, required): The agreement to close (terminal).
- `confirm` (boolean): Omit/false to DRY-RUN (preview the terminal true-up + freeze); true to post the Adjustment and close.
- `force` (boolean): Administrative close flag, recorded on the audit trail (the true-up always resolves the open balance regardless).
- `reason` (string): Why it's being closed — recorded on the audit trail.

### `defunct_agreement` (~204 tokens)

Retire a WRONG agreement that has already accrued — reverse its postings, then archive it. Voiding alone only stops FUTURE accruals; this UNWINDS what already accrued by appending a Reversal for every earning event (earned → $0, strictly append-only — the originals AND the reversals both stay on the ledger for audit), then voids the agreement. Call WITHOUT confirm first to DRY-RUN — it reports how many postings and how much $ will be reversed and warns if any was already settled (a clawback). Call again with confirm:true to apply. Refuses if the agreement is posted to the ERP (supersede it instead). Needs the agreement_id. Requires a connected Aurgus account.

Input parameters:

- `agreement_id` (string, required): The agreement to reverse & defunct.
- `confirm` (boolean): Omit/false to DRY-RUN (preview the reversal); true to actually reverse the postings and archive the agreement.

### `true_up` (~198 tokens)

True-up an agreement — AFTER a settlement, match the accrual account to what was ACTUALLY settled. Posts ONE Adjustment (signed = settled − earned) in the CURRENT period so earned equals settled and the open balance nets to $0. Over-accrued → a negative Adjustment; under-accrued → a positive one. Always current-period, never backdated. Append-only and idempotent (a second run finds it already matched). Call WITHOUT confirm to DRY-RUN (shows the exact Adjustment and the before/after); call again with confirm:true to apply. This is also the first step of a close-out (close does the true-up then flags the agreement closed). Needs the agreement_id. Requires a connected Aurgus account.

Input parameters:

- `agreement_id` (string, required): The agreement to true up.
- `confirm` (boolean): Omit/false to DRY-RUN (preview the Adjustment); true to post it.

### `edit_agreement_rates` (~346 tokens)

Change the RATES on a rate-routed (dimension-routed) agreement — a regime's flat rate, a tiered regime's own ladder, or the shared tier ladder. Rates are given in PERCENT (1.5 = 1.5%); thresholds in dollars. Call WITHOUT confirm first to DRY-RUN: with no edits it LISTS the current regimes (their keys + rates) so you know what to change; with edits it echoes the intended change. Call again with confirm:true to apply. On apply the new rate goes live for future transactions immediately, and — because it moves money on already-accrued periods — a gated Recalculate card is raised that the operator approves in the workspace (the past-period adjustment posts only on approval; nothing is backdated through you). Structure (routing dimension, regime keys, member values) is NOT editable here — only rates. Refuses if posted to the ERP (supersede instead). Needs the agreement_id. Requires a connected Aurgus account.

Input parameters:

- `agreement_id` (string, required): The rate-routed agreement to edit.
- `confirm` (boolean): Omit/false to DRY-RUN (list current rates or echo the change); true to apply and raise the gated Recalculate card.
- `regimes` (array): Per-regime rate edits, keyed by the regime's key (from the dry-run list). Give flat_rate_pct for a flat regime, or tiers for a tiered regime's own ladder.
- `shared_tier_grid` (array): The shared tier ladder (used by tiered regimes that tier on the whole book). Thresholds in dollars, rate in percent.

### `edit_agreement` (~403 tokens)

Change an agreement's TERMS — its name, the counterparty (customer_name), the direction (payable_sell_side = you pay a rebate / receivable_buy_side = you earn one), the validity window (valid_from / valid_to, YYYY-MM-DD; pass valid_to:null for open-ended), or the accrual / settlement cadence. Send only the fields to change. This runs the SAME governed core as the workspace edit form (one implementation): activating is blocked if the config isn't ASC-606-conformant; a cadence/validity value must satisfy the agreement type's contract; direction and type are posting-locked once a document hits the ERP; and because a validity change re-evaluates already-accrued periods, it does NOT post money through you — it raises a gated Recalculate card the operator approves in the workspace (nothing is backdated without approval). To CHANGE RATES use edit_agreement_rates; to change STATUS use the audited status flow. Needs the agreement_id. Requires a connected Aurgus account.

Input parameters:

- `accrual_cadence` (string): How often to accrue: realtime | daily | weekly | monthly | per_event.
- `agreement_id` (string, required): The agreement to edit.
- `customer_name` (string): New counterparty / customer name.
- `direction` (string): payable_sell_side (you pay the rebate) or receivable_buy_side (you earn it). Posting-locked once a document is posted to the ERP.
- `name` (string): New agreement name.
- `settlement_cadence` (string): How often it settles: weekly | semi_monthly | monthly | quarterly | semi_annual | annual | threshold | ad_hoc.
- `valid_from` (string): New validity start, YYYY-MM-DD (bare calendar date).
- `valid_to` (string|null): New validity end, YYYY-MM-DD, or null for open-ended. A validity change raises a gated Recalculate card.

### `analyze` (~289 tokens)

Build a GOVERNED analytics report over the rebate data. Pick a MEASURE and GROUP it BY a dimension — the report is composed from a fixed semantic layer (no raw SQL), so it's deterministic, read-only, and ties to the ledger (accrued uses the SAME earned formula as the money path). measure: 'accrued' (earned rebate), 'settled' (paid), 'basis' (transaction amount), or 'count' (events). group_by: 'agreement', 'class' (a declared dimension — pass dimension_key, e.g. interchange_class), 'month', or 'quarter'. Optionally restrict to one agreement_id. Returns the grouped rows + total. Use this when the user asks to see/analyze/break down their rebates (e.g. 'rebate accrued by interchange class', 'settled by month'). Requires a connected Aurgus account.

Input parameters:

- `agreement_id` (string): Optional — restrict the report to one agreement.
- `dimension_key` (string): Required when group_by='class': the declared dimension to group by, e.g. 'interchange_class'.
- `group_by` (string, required): How to break it down: agreement | class (needs dimension_key) | month | quarter.
- `measure` (string, required): What to measure: accrued (earned) | settled (paid) | basis (transaction amount) | count (events).

### `save_report` (~172 tokens)

Save an analytics report for reuse. Give it a NAME plus the same measure / group_by (/ dimension_key / agreement_id) you'd pass to `analyze` — the governed spec is stored under that name (re-saving the same name updates it). Later, `run_report` re-runs it on current data. Requires a connected Aurgus account.

Input parameters:

- `agreement_id` (string): Optional — restrict to one agreement.
- `dimension_key` (string): Required when group_by='class' — e.g. interchange_class.
- `group_by` (string, required): agreement | class (needs dimension_key) | month | quarter.
- `measure` (string, required): accrued | settled | basis | count.
- `name` (string, required): A name to save this report under (e.g. 'Rebate by class').

### `list_reports` (~44 tokens)

List the saved analytics reports on this tenant (name + what each measures). Use `run_report` with a name to re-run one. Requires a connected Aurgus account.

### `run_report` (~64 tokens)

Re-run a SAVED analytics report by name on current data — returns the grouped rows + total, governed and read-only exactly like `analyze`. Requires a connected Aurgus account.

Input parameters:

- `name` (string, required): The saved report's name (see `list_reports`).

### `recalculate` (~138 tokens)

Recalculate — re-run the deterministic engine over the POS data, dispatching every row against the agreement(s) so rows that just became eligible (e.g. after a data fix or a rule change) accrue. Posts provisional accruals (the same engine compute_close uses); rows that already have a positive accrual are skipped (idempotent). Pass agreement_id to recompute ONE agreement, or omit it to recompute ALL active agreements. Returns the events created and the accrual total. Requires a connected Aurgus account.

Input parameters:

- `agreement_id` (string): Recompute just this agreement. Omit to recompute all active agreements.

### `connect_integration` (~353 tokens)

Connect the client's ERP / POS / order system (or Zapier) to Aurgus by creating an API key for their account. This is how transactions flow IN automatically (no CSV uploads) and how Aurgus's journal entries flow OUT to their GL — through the Aurgus Open-API (/api/v1) that the key authenticates. The key carries DATA-INTAKE authorization ONLY: it can push transactions and read the journal/position, but it can NEVER run a close, settle, or move money — those stay human-gated in the workspace. Because a key is a real credential, call WITHOUT confirm first to explain what will be created and ask; the MOMENT the user says yes / 'create it' / 'go ahead', call again with confirm:true to actually create it — do NOT re-ask or re-confirm. NEVER ask the user for a label: it is optional, so omit it unless the user volunteered one in the same breath; they can rename the key later in Account. On creation the plaintext key is returned ONCE with the steps to finish in Zapier. The person can view or revoke keys anytime in Account → API keys. Use this when the user asks to connect their system, integrate their ERP/POS, or set up Zapier. Requires a connected Aurgus account.

Input parameters:

- `confirm` (boolean): Omit/false to EXPLAIN what will be created and ask; true to actually create the key and return it once.
- `label` (string): Optional label. Set it ONLY if the user already named one (e.g. 'Zapier'); otherwise OMIT it and do not ask — never block key creation on a label.

### `settle` (~207 tokens)

Settle an agreement — post the PAYOUT. Creates per-bucket Settlement event(s) totalling the open accrual (earned − already settled), moving the open balance to $0. This is the money-OUT step (distinct from compute_close, which accrues, and true_up, which reconciles the accrual to a prior settlement). Call WITHOUT confirm to DRY-RUN — it reports the open accrual that would be paid and any gate that blocks it (a named settlement approver, an incomplete agreement, or an anomaly hold). Call again with confirm:true to post it. Governed by the SAME gates as the workspace Settle button (one core). Needs the agreement_id. Requires a connected Aurgus account.

Input parameters:

- `agreement_id` (string, required): The agreement to settle (pay out its open accrual).
- `confirm` (boolean): Omit/false to DRY-RUN (preview the payout + any blocking gate); true to post the Settlement event(s).

### `trace` (~101 tokens)

Walk any accrued figure all the way back to where it came from — source row → eligibility → bucket → rate → rule → event chain — for a given transaction. This is how you show an auditor exactly why a number is what it is. Requires a connected Aurgus account.

Input parameters:

- `agreement_id` (string): Optional — limit to one agreement; otherwise all agreements that fired on the row.
- `source_transaction_id` (string, required): The transaction id to trace.

### `export` (~66 tokens)

Put together the auditor-ready package for your tenant: the open accrual you can stand behind (earned → settled → open), where margin is leaking versus what's sitting outside any program, and sample lineage tracing back to source — all computed off the canonical ledger. Requires a connected Aurgus account.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-aurgus-aurgus/api-mcp#diagnostics

## Score history

- 2026-11-05: 67
- 2026-11-04: 67
- 2026-11-03: 66
- 2026-11-02: 66
- 2026-11-01: 65

## Common questions

### What is the com.aurgus/aurgus MCP server?

com.aurgus/aurgus is an MCP server listed in the public MCP registry as com.aurgus/aurgus. Governed rebate & revenue close (ASC 606/705/842): explain, ingest, compute, trace to source. This page covers its hosted endpoint (https://mcp.aurgus.com/api/mcp).

### Is the com.aurgus/aurgus MCP server safe to use?

com.aurgus/aurgus scores 67 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the com.aurgus/aurgus MCP server expose?

com.aurgus/aurgus exposes 38 tools: begin, help, release_notes, explain, request_real_run, and 33 more. Their descriptions and schemas cost roughly 8,349 tokens of context every time the server is loaded.

### Does the com.aurgus/aurgus MCP server require authentication?

No. We connected to com.aurgus/aurgus without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the com.aurgus/aurgus MCP server still maintained?

com.aurgus/aurgus is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://mcp.aurgus.com/api/mcp
- Website: https://aurgus.com/
- Changelog RSS feed: https://verifymcp.io/servers/com-aurgus-aurgus/api-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-aurgus-aurgus/api-mcp.json
- HTML version of this page: https://verifymcp.io/servers/com-aurgus-aurgus/api-mcp
