# US compliance and books health (remote · medianfi.com)

US company filing obligations, plus a 25-check bookkeeping diagnostic. Sourced, dated, no signup.

- Trust score: 79/100 (medium)
- Change this week: +2
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-25

## Components

- remote · `medianfi.com`: 79/100 (this document), [markdown](https://verifymcp.io/servers/com-medianfi-compliance/medianfi.md), [page](https://verifymcp.io/servers/com-medianfi-compliance/medianfi)

## Channel facts

- Endpoint: `https://medianfi.com/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-09-25.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 12 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - 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**: 64/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3932 tokens (~327/item across 12 items; 12 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 100/100
  - No destabilizing schema changes in the last 30 days.
- **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 12 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 13 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the US compliance and books health MCP server?

US compliance and books health is a hosted endpoint at https://medianfi.com/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-medianfi-compliance 'https://medianfi.com/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "com-medianfi-compliance": {
      "url": "https://medianfi.com/mcp"
    }
  }
}
```

### VS Code

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

### Codex

```toml
[mcp_servers.com-medianfi-compliance]
url = "https://medianfi.com/mcp"
```

### opencode

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

### OpenClaw

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

### Hermes

```yaml
mcp_servers:
  com-medianfi-compliance:
    url: "https://medianfi.com/mcp"
```

### Netclaw

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

### Vellum

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

### Other

```json
{
  "mcpServers": {
    "com-medianfi-compliance": {
      "type": "http",
      "url": "https://medianfi.com/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-09-25 (score 79, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-09-21 (score 79, +1)

- [security] Stability: 0.97 → pass

### 2026-09-20 (score 78, 0)

- [cosmetic] “get_blog_post” reworded the description of “slug”

### 2026-09-19 (score 78, +1)

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

### 2026-09-18 (score 77, 0)

- [cosmetic] “get_confounders” reworded the description of “revenue_band”
- [cosmetic] “list_compliance_obligations” reworded the description of “revenue_band”

### 2026-09-17 (score 77, +1)

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

### 2026-09-15 (score 76, +1)

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

### 2026-09-13 (score 75, +1)

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

## MCP tools (12)

### `get_company_overview` (~39 tokens)

Get company overview

Who Median is, what it does, who it is for, how onboarding works, and how to get in touch or book an intro call.

### `get_pricing` (~68 tokens)

Get pricing

Median's published pricing: the flat monthly fee by revenue band under $1M in annual revenue, the per-account and per-ledger-entry meter that scoping is based on above $1M, what is included, and add-on pricing for tax, R&D credits, and sales tax.

### `list_services` (~38 tokens)

List services

List the services Median offers (daily bookkeeping, tax filing, R&D tax credits, CFO advisory) with a short summary and page link for each.

### `list_blog_posts` (~80 tokens)

List blog posts

List published articles from the Median blog, newest first. Optionally filter by category or a search term matched against the title.

Input parameters:

- `category` (string): Filter to one category slug or name.
- `limit` (integer): How many posts to return (default 20, max 50).
- `search` (string): Match against the post title.

### `get_blog_post` (~43 tokens)

Get blog post

Fetch the full text of one published Median blog post by its slug.

Input parameters:

- `slug` (string, required): Post slug, e.g. 'how-to-switch-bookkeeping-services'.

### `get_confounders` (~797 tokens)

Get confounding questions

Refinement step, NOT the place to start: call list_compliance_obligations first, then call this to narrow what is still genuinely open. Returns the facts that flip an answer, such as whether an employer of record is the legal employer. Pass every fact you already know and it returns only what those facts leave unsettled. These are things for YOU to look up in the user's own documents. They are not a questionnaire to send the user.

Input parameters:

- `answered` (object): Only for confounders with no matching fact field above (who-paid, prepaid-multi-year). For everything else pass the fact itself, e.g. payroll_model: 'eor', not answered: { 'payroll-model': 'eor' }.
- `answers` (object): Answers to the yes/no threshold questions this tool asks, keyed by the threshold id shown in the question, e.g. { "foreign-accounts-over-10k": false, "ny-sales-over-500k": false }. Without this the s…
- `company_name` (string): Optional, and the only identifying thing this tool records. Median stores it to see which companies use this tool and may follow up. It changes nothing about the answer, so omit it if the user has no…
- `contractor_states` (array): States where 1099 contractors work.
- `employee_states` (array): States where W-2 employees work.
- `entity_type` (string): Legal entity type.
- `extensions_filed` (object): Whether a tax extension was filed, keyed 'US' for federal and by state code, e.g. { US: true, NY: false }. OMIT a key you are unsure about: no deadline is asserted for an unknown key, because assumin…
- `fiscal_year_end` (string): MM-DD, e.g. '12-31'. Defaults to 12-31.
- `foreign_owned`: Whether any non-US person owns 25% or more. Leave unset if genuinely unknown.
- `formation_date` (string): ISO date the entity was formed.
- `formation_platform` (string): Decides whether a bundled first-year registered agent explains a missing fee.
- `formation_state` (string): Two-letter state of formation, e.g. 'DE'.
- `operating_states` (array): States where the company operates.
- `payroll_model` (string): Critical. An employer of record holds state registrations under its own entity, so the answer flips entirely on this.
- `payroll_provider` (string): The provider's name only, e.g. 'Deel', 'Gusto', 'Rippling'. Not account numbers, not employee details, not anything else.
- `presence_type` (object): Per-state presence, e.g. { NY: 'virtual-mailbox' }.
- `registered_in` (object): Whether the company is already registered to do business in a state, e.g. { NY: false }. Drives obligations that only begin at registration.
- `revenue_band` (string): Gross annual revenue as a band, never an exact figure: 'pre-revenue', 'under-250k', '250k-1m', '1m-5m' or 'over-5m'. Drives revenue-scaled thresholds such as state franchise tax minimums and economic…
- `sales_states` (array): States with customers.
- `sells_saas`: Whether the product is SaaS. New York taxes SaaS as prewritten software.
- `tax_year` (integer): Tax year under review. Defaults to last calendar year.

### `list_compliance_obligations` (~946 tokens)

List compliance obligations

START HERE. Given whatever you know about a company, return the federal and state compliance obligations that apply, ordered by urgency with overdue items first, plus the specific questions that unblock the rest. Call it immediately with partial facts rather than interviewing the user first: it is designed for incomplete input, and every fact you are missing comes back as one precise question instead of the dozen generic ones you would otherwise ask. Then answer those and call it again. Defaults to a short actionable view; relay it roughly as written rather than expanding it into an essay, and pass detail='full' only when the user asks for evidence tiers and remediation detail. Covers US federal plus CA, CO, DE, FL, GA, IL, MA, NJ, NY, PA, TX and WA; every other state is reported honestly as not yet covered. This never tells you whether you are compliant, only what to check.

Input parameters:

- `answers` (object): Answers to the yes/no threshold questions this tool asks, keyed by the threshold id shown in the question, e.g. { "foreign-accounts-over-10k": false, "ny-sales-over-500k": false }. Without this the s…
- `company_name` (string): Optional, and the only identifying thing this tool records. Median stores it to see which companies use this tool and may follow up. It changes nothing about the answer, so omit it if the user has no…
- `contractor_states` (array): States where 1099 contractors work.
- `detail` (string): Default 'brief': what applies, when it is due, and the questions, with no evidence or remediation detail. Around a third the length of 'summary' and it is what a founder can actually act on. 'summary…
- `employee_states` (array): States where W-2 employees work.
- `entity_type` (string): Legal entity type.
- `extensions_filed` (object): Whether a tax extension was filed, keyed 'US' for federal and by state code, e.g. { US: true, NY: false }. OMIT a key you are unsure about: no deadline is asserted for an unknown key, because assumin…
- `fiscal_year_end` (string): MM-DD, e.g. '12-31'. Defaults to 12-31.
- `foreign_owned`: Whether any non-US person owns 25% or more. Leave unset if genuinely unknown.
- `formation_date` (string): ISO date the entity was formed.
- `formation_platform` (string): Decides whether a bundled first-year registered agent explains a missing fee.
- `formation_state` (string): Two-letter state of formation, e.g. 'DE'.
- `operating_states` (array): States where the company operates.
- `payroll_model` (string): Critical. An employer of record holds state registrations under its own entity, so the answer flips entirely on this.
- `payroll_provider` (string): The provider's name only, e.g. 'Deel', 'Gusto', 'Rippling'. Not account numbers, not employee details, not anything else.
- `presence_type` (object): Per-state presence, e.g. { NY: 'virtual-mailbox' }.
- `registered_in` (object): Whether the company is already registered to do business in a state, e.g. { NY: false }. Drives obligations that only begin at registration.
- `revenue_band` (string): Gross annual revenue as a band, never an exact figure: 'pre-revenue', 'under-250k', '250k-1m', '1m-5m' or 'over-5m'. Drives revenue-scaled thresholds such as state franchise tax minimums and economic…
- `sales_states` (array): States with customers.
- `sells_saas`: Whether the product is SaaS. New York taxes SaaS as prewritten software.
- `tax_year` (integer): Tax year under review. Defaults to last calendar year.

### `get_evidence_recipe` (~78 tokens)

Get evidence recipe

For one obligation, return exactly how to prove it: which sources settle the question, which are only corroborating, what each state's public registry does and does not expose, and the innocent explanations for missing evidence. Use this before concluding anything is missing.

Input parameters:

- `obligation_id` (string, required): Obligation id from list_compliance_obligations.

### `explain_obligation` (~64 tokens)

Explain one obligation

Plain-English detail on a single obligation: what it is, why it exists, the deadline, the cost, the penalty, the exact remediation steps, and the government source.

Input parameters:

- `obligation_id` (string, required): Obligation id, e.g. 'de-registered-agent'.

### `list_books_checks` (~411 tokens)

List books health checks

START HERE for a books health check. Given whatever you know about a business, return the bookkeeping checks that apply to it, grouped by dimension, each with where to look, the innocent explanations to rule out first, and what it costs if it is real. Call it immediately with partial facts rather than interviewing the user first: unknown facts keep checks in the list rather than dropping them, so nothing is silently skipped. Cash-basis businesses correctly get a shorter list. This never says whether books are correct, only what to look at.

Input parameters:

- `basis` (string): Cash or accrual, printed at the top of most profit and loss reports. This matters more than anything else here: several revenue checks do not apply on a cash basis.
- `bills_ahead` (boolean): Whether anything is billed ahead of delivery: subscriptions, retainers, annual plans.
- `charges_sales_tax` (boolean): Whether sales tax is charged anywhere.
- `company_name` (string): Optional, and the only identifying thing this tool records. Median stores it to see which businesses use this tool and may follow up. It changes nothing about the answer, so omit it if the user has n…
- `has_contractors` (boolean): Whether 1099 contractors are paid.
- `has_raised` (boolean): Whether the business has raised on a SAFE, note or priced round, or taken a loan.
- `ledger` (string): Which ledger the books live in. Visible in the header of any export.
- `needs_segment_reporting` (boolean): Whether any part of the business needs separate reporting: locations, programs, product lines, more than one entity.
- `payroll_model` (string): How people are paid.
- `processors` (array): Payment processors that hold a balance before paying out, e.g. ['stripe','paypal']. Names only. Drives the single most-missed check.

### `explain_books_check` (~90 tokens)

Explain one books check

Full detail on a single books health check: what it is, exactly where to look in the ledger, every innocent explanation to rule out before concluding anything, what it costs if it is real, what fixing it involves, and whether it is inside what Median does.

Input parameters:

- `check_id` (string, required): Check id from list_books_checks, e.g. 'rec-processor-balance-unreconciled'.

### `score_books_health` (~422 tokens)

Score books health

Score a books health check from the statuses you actually evidenced. Returns the weighted score, the band, a per-dimension breakdown and the findings ranked worst first. Two rules a plain average does not give you: a confirmed critical caps the grade, and the band is WITHHELD entirely when too little was evidenced, because a flattering number off three checks is the part people quote. Report the withheld state rather than supplying a band yourself.

Input parameters:

- `basis` (string): Cash or accrual, printed at the top of most profit and loss reports. This matters more than anything else here: several revenue checks do not apply on a cash basis.
- `bills_ahead` (boolean): Whether anything is billed ahead of delivery: subscriptions, retainers, annual plans.
- `charges_sales_tax` (boolean): Whether sales tax is charged anywhere.
- `company_name` (string): Optional, and the only identifying thing this tool records. Median stores it to see which businesses use this tool and may follow up. It changes nothing about the answer, so omit it if the user has n…
- `has_contractors` (boolean): Whether 1099 contractors are paid.
- `has_raised` (boolean): Whether the business has raised on a SAFE, note or priced round, or taken a loan.
- `ledger` (string): Which ledger the books live in. Visible in the header of any export.
- `needs_segment_reporting` (boolean): Whether any part of the business needs separate reporting: locations, programs, product lines, more than one entity.
- `payroll_model` (string): How people are paid.
- `processors` (array): Payment processors that hold a balance before paying out, e.g. ['stripe','paypal']. Names only. Drives the single most-missed check.
- `results` (array, required): One entry per check you actually worked. Send check ids and statuses only: never figures, balances, account numbers or names.

## Diagnostics

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

## Score history

- 2026-09-25: 79
- 2026-09-24: 79
- 2026-09-23: 79
- 2026-09-22: 79
- 2026-09-21: 79
- 2026-09-20: 78
- 2026-09-19: 78
- 2026-09-18: 77
- 2026-09-17: 77
- 2026-09-16: 76
- 2026-09-15: 76
- 2026-09-14: 75
- 2026-09-13: 75
- 2026-09-12: 74
- 2026-09-11: 74
- 2026-09-10: 73
- 2026-09-09: 73
- 2026-09-08: 72
- 2026-09-07: 72
- 2026-09-06: 71
- 2026-09-05: 71
- 2026-09-04: 70
- 2026-09-03: 70
- 2026-09-02: 70
- 2026-09-01: 69
- 2026-08-31: 69
- 2026-08-30: 68
- 2026-08-29: 68
- 2026-08-28: 67
- 2026-08-27: 67

## Common questions

### What is the US compliance and books health MCP server?

US compliance and books health is an MCP server listed in the public MCP registry as com.medianfi/compliance. US company filing obligations, plus a 25-check bookkeeping diagnostic. Sourced, dated, no signup. This page covers its hosted endpoint (https://medianfi.com/mcp).

### Is the US compliance and books health MCP server safe to use?

US compliance and books health scores 79 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 US compliance and books health MCP server expose?

US compliance and books health exposes 12 tools: get_company_overview, get_pricing, list_services, list_blog_posts, get_blog_post, and 7 more. Their descriptions and schemas cost roughly 3,076 tokens of context every time the server is loaded.

### Does the US compliance and books health MCP server require authentication?

No. We connected to US compliance and books health without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the US compliance and books health MCP server still maintained?

US compliance and books health is still listed as active in the MCP registry. We last reached this channel on 25 September 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://medianfi.com/mcp
- Repository: https://github.com/median-labs/median-compliance-skill
- Website: https://medianfi.com/compliance
- Changelog RSS feed: https://verifymcp.io/servers/com-medianfi-compliance/medianfi.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-medianfi-compliance/medianfi.json
- HTML version of this page: https://verifymcp.io/servers/com-medianfi-compliance/medianfi