US compliance and books health

com.medianfi由 medianfi.com 发布官方发布者v1.0.0更新于 Oct 24, 2026

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

已验证Streamable HTTP可网页运行金融知识与记忆商业与电商

概览

AI 生成的概览

一个远程 MCP 服务器,可推算美国公司需向联邦和州政府申报的义务,并提供 25 项账簿健康检查诊断。

可以做什么
按实体类型和经营州列出适用的联邦与州合规义务,按紧急程度排序,并给出后续问题和会改变结论的关键事实;对单项义务提供通俗说明、截止日期、费用、罚则和整改步骤,以及证明已履行的取证方法。运行账簿健康检查:按维度列出适用的记账检查项,逐项详解,并根据已取证的状况给出加权评分、等级和按严重程度排序的发现。读取 Median 的公司介绍、公开定价、服务清单和博客文章。
适用场景
适合创始人或财务负责人想了解美国公司需要申报什么、申报是否及时,或账簿是否存在常见问题,且不希望注册账号时使用。也适合查阅 Median 的定价和服务信息。
运行要求
远程 streamable HTTP 端点;未声明需要注册、API 密钥或账号。可选的配套技能需单独安装,服务器本身不依赖它。公共端点有速率限制。
安装前请注意
它不代为申报,不登录政府网站,也不构成法律或税务建议。助手在本地读取文件,仅发送结构化事实,但 Median 会记录这些事实、返回结果,以及助手选择发送的公司名称。覆盖范围为美国联邦加 12 个州,其他州会明确标为未覆盖。规则可能过时,行动前应查看所标注的核验日期。

安装

在 SourceWeft 中

  1. 打开 控制台中的 US compliance and books health,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.medianfi%2Fcompliance/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "us-compliance-and-books-health": {
      "type": "http",
      "url": "https://medianfi.com/mcp"
    }
  }
}

README

Company compliance check

A free skill and MCP server that works out what your US company actually has to file with federal and state governments, then goes looking through your own documents for evidence you have done it.

Your documents never leave your machine. The server only ever receives structured facts like entity type and which states you operate in.

Why this exists

On 2026-08-11 FinCEN permanently ended beneficial ownership reporting for US companies and started deleting the data it had collected. Almost every compliance checklist on the internet, and most AI assistants, still tell founders to file it.

That is the problem in one example. The rules move, and anything with the rules baked in goes stale silently. This keeps the rules on a server so they can be corrected in one place, and every single item links to the government's own page with the date it was last checked.

Install

Two pieces. The server carries the rules and is the part that matters. The skill teaches your assistant how to search your own documents for evidence, and is optional.

The server is https://medianfi.com/mcp. No signup, no API key, no account.

Where you areHow to add itSkill
Claude desktop or claude.aiSettings > Connectors > Add custom connector, paste the URL, AddDownload this repo as a ZIP and upload it under Customize > Skills
Claude Codeclaude mcp add --transport http --scope user median https://medianfi.com/mcpnpx skills add https://github.com/median-labs/median-compliance-skill
ChatGPTSettings > Connectors > AddNot supported, the server alone still works

Add the server before you start the session you plan to use it in. A connector added mid-session does not appear until the client reloads, and an assistant that cannot reach the rules will answer from its own training data instead, which is the failure this whole project exists to prevent. If the claude command is not on your PATH you are on the desktop app: use its settings UI, and do not hand-edit ~/.claude.json.

Then ask, naming the company:

Check whether Acme Robotics Inc is up to date on its filings.

Name it even if it is the only company you own. Your assistant can see every entity whose paperwork has ever passed through your machine, and naming one keeps the answer about that one.

What it does

  1. Reads what it can find about your company first, then asks you to correct it, rather than making you fill in a form.
  2. Settles the questions that change the answer before deriving anything. The big one is who your legal employer is: if you are on an employer of record, the state payroll registrations sit under their entity and you are supposed to have none of your own.
  3. Works out what applies to your entity type and footprint.
  4. Hunts for evidence in your files, email and connected tools, strongest source first.
  5. Where it cannot find something, it tells you the likely innocent explanation before asking you a question about it.
  6. Gives you a report with the deadline, the cost, the exact fix and the government link for each item.

What it will not do

It will not tell you that you are compliant. It is a checklist and a document finder, not legal or tax advice, and not a substitute for your attorney or accountant. It does not file anything, and it never logs in to a government site as you.

It also will not tell you something is missing just because it could not find a receipt. A missing document usually means a bundled fee, a personal card, a lawyer's inbox, or a registry that does not publish that field. Every item carries the innocent explanations, and unresolved stays unresolved rather than turning into a false alarm.

Coverage

156 obligations across 13 jurisdictions: US federal plus California, Colorado, Delaware, Florida, Georgia, Illinois, Massachusetts, New Jersey, New York, Pennsylvania, Texas and Washington. Entity types: C corporation, S corporation, LLC, single-member LLC (including foreign-owned), partnership, benefit corporation and nonprofit. Categories: entity filings, registered agents, income and franchise tax, payroll, unemployment, workers compensation, sales tax and information returns.

Every other state is reported as not covered, with a link to that state's Secretary of State and tax authority. That is deliberate. An invented rule is worse than an honest gap.

Every rule carries the government page it came from and the date it was last checked. Where a fee or deadline could not be confirmed at the source, the obligation still appears but the number is withheld rather than guessed.

A few things it knows that most sources get wrong

  • BOI reporting is over for US-formed companies as of the 2026-08-11 final rule. If you get an invoice to file or renew one, you do not need it.
  • The corporate and pass-through extended deadlines are different, and get swapped constantly. A calendar-year C corporation extends to October 15. A partnership or S corporation extends to September 15. Reading the statute alone gets the C corporation answer wrong, because Treasury grants a flat six months by regulation.
  • Delaware franchise tax is often calculated the expensive way. You are allowed to recalculate using the assumed par value capital method, which for a startup with lots of authorized shares and few assets can turn a five-figure bill into a few hundred dollars.
  • A virtual mailbox in a state is not the same as doing business there. Where your people are is what decides foreign qualification.
  • New York sales tax economic nexus needs both tests, over $500,000 in receipts AND over 100 transactions. New York is one of only two states using AND rather than OR.
  • New Jersey's Corporate Transit Fee is a cliff, not a band. Once taxable net income crosses $10 million the 2.5% applies to the entire amount, not the excess, so $10.1 million owes roughly $252,000 rather than $2,500.
  • New Jersey still has the 200-transaction sales tax prong. Several sites claim it was repealed in 2024. It was not, and the repeal bills introduced in January 2026 are not enacted.
  • Georgia's corporate rate is 4.99% for 2026 under HB 463, signed May 2026. The Department of Revenue's own corporate page is stale at 5.19%.
  • State registries publish more for free than almost anyone assumes. Delaware gives you the registered agent, Colorado gives you good-standing certificates, Pennsylvania gives you officers and governors, all at no charge. A tool that sends you to a paid lookup for those is wrong.

Maintenance, and how to tell us a rule is wrong

Maintained by Jacob Sheldon at Median. Rules are re-verified against their government sources on a monthly cycle, first Monday, and any rule older than 90 days is rechecked or withdrawn.

Every report states the oldest verification date across the rules it used, as "Sources verified through YYYY-MM-DD". That is deliberately the oldest and not the newest, so one freshly checked rule cannot make a stale report look current. Treat anything near that horizon as needing a look at the source before you act.

If you find a rule that is wrong, open an issue with the obligation id and the government page that contradicts it. Wrong rules get fixed or pulled, not argued with. The dataset already carries corrections from about a third of what single-source research first produced, so this is expected rather than embarrassing.

Rules move fast enough that this matters: FinCEN ended BOI reporting by final rule three days before this shipped, and most checklists online still say to file.

Privacy, and what gets sent

Your documents never leave your machine. The assistant reads your files, email and accounts locally, and sends the server only structured facts: entity type, state and date of formation, two-letter state codes, a revenue band rather than any figure, the payroll and incorporation arrangement, and yes or no answers to threshold questions.

It never sends documents, EINs, addresses, people's names, bank details or dollar amounts. No field accepts them.

Median logs those structural facts, what came back, and a company name if your assistant chooses to send one. That field is optional and the answer is identical without it, so leave it out if you would rather Median not know you ran this. Use is subject to Median's terms and privacy policy.

The public endpoint is rate limited. A normal session needs a handful of calls; if you are getting 429s, something is looping.

Who made this

Median, the finance team for owner-led businesses and US startups. We keep books current and file taxes. We built this because our own customers kept asking the same question and there was no good free answer.

We do not do compliance filings, so most of what this finds routes you to the government's own page rather than to us. Where an item is something we genuinely do, it says so.

License

MIT. Fork it, change it, ship it.

Which also means: provided as is, without warranty of any kind, and the authors are not liable for anything that follows from using it. This is a reference tool. Confirm anything you act on at the government's own page, which every item links to, and talk to an accountant or attorney licensed where you operate before making a decision that costs money.

来源:README.md,提交 a48a361

工具

12

get_company_overview

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

Get pricing

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

无需输入参数。

list_services

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

List blog posts

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

输入参数limitsearchcategory

get_blog_post

Get blog post

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

输入参数slug必填

get_confounders

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.

输入参数answersansweredtax_yearsells_saasentity_typecompany_namerevenue_bandsales_statesforeign_ownedpayroll_modelpresence_typeregistered_in另有 9 个

list_compliance_obligations

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.

输入参数detailanswerstax_yearsells_saasentity_typecompany_namerevenue_bandsales_statesforeign_ownedpayroll_modelpresence_typeregistered_in另有 9 个

get_evidence_recipe

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.

输入参数obligation_id必填

explain_obligation

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.

输入参数obligation_id必填

list_books_checks

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.

输入参数basisledgerhas_raisedprocessorsbills_aheadcompany_namepayroll_modelhas_contractorscharges_sales_taxneeds_segment_reporting

explain_books_check

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.

输入参数check_id必填

score_books_health

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.

输入参数basisledgerresults必填has_raisedprocessorsbills_aheadcompany_namepayroll_modelhas_contractorscharges_sales_taxneeds_segment_reporting

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Medianfi 集成