mcpField
D
delaware-franchise-tax

delaware-franchise-tax

github.com/open-agreements其他6150 次安装5 天前更新
代码仓库

关于 delaware-franchise-tax

引导用户申报 Delaware 特许税和年度报告的技能,适用于 C-Corp、LLC、LP 和 GP。它会收集申报资料、计算 C-Corp 的两种税额方案,并引导用户通过官方门户完成申报;支付信息始终由用户输入。

主要功能

  1. 01收集实体及申报所需资料
  2. 02计算 C-Corp 两种税额方案
  3. 03引导使用官方门户提交年度报告
  4. 04可选通过 Playwright 协助门户操作
  5. 05保存回执并提示设置年度提醒

适用场景

  1. 01准备 Delaware 年度特许税申报
  2. 02比较 C-Corp 的两种计税方式
  3. 03逐步填写 Delaware 官方申报门户
  4. 04归档申报回执并安排下次提醒

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/open-agreements/open-agreements --skill delaware-franchise-tax

安装后在 Claude Code 中输入/delaware-franchise-tax确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

CONNECTORS.md
reference/
ecorp-portal-playwright-notes.md
faq.md
filing-instructions.md
tax-calculation.md

详细介绍

特拉华州特许经营税

申报特拉华州年度特许经营税和年度报告。

交互说明:始终向用户询问缺失的信息。 如果你的 Agent 有 AskUserQuestion 工具(Claude Code、Cursor 等), 请优先使用该工具——结构化问题更便于用户回答。 否则,请用自然语言提问。

安全模型

  • 此技能不会下载或执行任何代码。
  • 所有门户网站操作均由用户在 Agent 的逐步指导下完成。
  • 如果用户选择启用浏览器自动化(通过 CDP 使用 Playwright),Agent 可以协助浏览门户网站——但信用卡和银行账户信息必须始终由用户直接输入。

适用场景

  • 每年在 3 月 1 日(C-Corps)或 6 月 1 日(LLCs/LPs/GPs)之前
  • 注册代理发送提醒时
  • 收到特拉华州公司部门的通知时
  • 门户网站开放时间:仅限美国东部时间上午 8:00 至晚上 11:45
  • 诈骗警告:特拉华州提醒公众警惕欺骗性招揽。合法通知仅来自州政府或你的注册代理。凡是要求你通过非官方渠道付款的内容,请予以丢弃。

阶段 1:收集信息

向用户询问以下信息(如果有 AskUserQuestion,请使用):

所有实体类型:

  • 实体类型:C-Corp 或 LLC/LP/GP
  • 特拉华州商业实体档案编号(最多 9 位数字)
  • 注册代理名称

C-Corps 还需提供:

  • 各类别的授权股份总数及面值(例如,10,000,000 股普通股,面值为 $0.00001)
  • 截至纳税年度 12 月 31 日已发行且流通在外的股份总数
  • 截至 12 月 31 日的总资产(见 Form 1120 Schedule L 第 15 行——也可根据银行余额 + 投资 + 应收款项估算)
  • 业务性质(简要说明公司如何产生收入)

高管和董事(C-Corps):

  • 高管:姓名、职务、地址
  • 董事:姓名、地址

阶段 2:计算税额

LLCs/LPs/GPs

固定年度税额为 $300。无需计算。跳至阶段 3。

C-Corps — 计算两种方法

始终计算两种方法,并推荐税额较低的方法。列出所有中间值,供用户核验。

方法 1:授权股份法
Shares <= 5,000:        $175 (minimum)
5,001 - 10,000:         $250
Each additional 10,000: +$85
Maximum:                $200,000

示例:10,000,000 股授权股份

  • 前 10,000 股:$250
  • 剩余 9,990,000 股 = 999 个每 10,000 股的增量:999 x $85 = $84,915
  • 合计:$250 + $84,915 = $85,165
方法 2:假定面值资本(APVC)法

对于初创公司,这种方法几乎总是更便宜。需要提供总资产数额。

Step 1: Assumed Par = Total Gross Assets / Total Issued Shares
Step 2: For each class of shares where assumed par >= stated par:
        use assumed par x number of authorized shares in that class
Step 3: For each class of shares where assumed par < stated par:
        use stated par x number of authorized shares in that class
Step 4: Sum all classes = Assumed Par Value Capital (APVC)
Step 5: Tax = (APVC rounded up to next $1,000,000 / $1,000,000) x $400
Step 6: Minimum tax: $400
Step 7: Maximum tax: $200,000

示例:10,000,000 股授权股份,面值为 $0.00001;1,000,000 股已发行;总资产为 $50,000

  • 步骤 1:假定面值 = $50,000 / 1,000,000 = $0.05
  • 步骤 2:$0.05 >= $0.00001,因此使用假定面值:$0.05 x 10,000,000 = $500,000
  • 步骤 4:APVC = $500,000
  • 步骤 5:向上取整至 $1,000,000 -> 1 x $400 = $400
申报费
  • 非免税国内公司的费用为 $50
  • 501(c)(3) 免税公司的费用为 $25

应缴总额 = 特许经营税 + 申报费

向用户展示两种计算结果:

Method 1 (Authorized Shares): $XX,XXX
Method 2 (Assumed Par Value):  $XXX
Recommended method:            Method 2
Filing fee:                    $50
Total due:                     $XXX + $50 = $XXX

阶段 3:通过门户网站申报

如果 Chrome 正在运行且已启用远程调试,Agent 可以使用 Playwright 自动操作门户网站。否则,请逐步指导用户操作。

自动化设置(通过 CDP 使用 Playwright)

如果用户说“使用 playwright”“使用浏览器”或提出类似的自动化请求:

  1. 启动启用了远程调试的 Chrome(命令参见 reference/ecorp-portal-playwright-notes.md)
  2. 通过 Playwright 连接(CDP 连接代码片段参见参考文档)
  3. 门户网站字段参考:参见 reference/ecorp-portal-playwright-notes.md,了解:
    • 所有字段选择器 ID
    • 日期字段的解决方法(必须使用 JS el.value =,而不是 Playwright .fill())
    • 州下拉菜单的缩写(使用 value="NY",而不是 label="New York")
    • 董事姓名字段(名、中间名和姓氏分别填写,不能填写在同一个姓名字段中)
    • APVC 启用顺序
    • 会话/eId 的行为
申报步骤
  1. 导航:打开 https://icis.corp.delaware.gov/ecorp/logintax.aspx
  2. 登录:输入 Business Entity File Number。解答 CAPTCHA(如果用户分享截图,Agent 可以尝试识别)。点击 Continue。
  3. 实体验证:确认实体名称、注册代理人和注册办事处与记录一致。
  4. 填写表单字段(均在同一页面上):
    • 股票信息:已发行股份(每个类别的字段,不是只读总数)、总资产、资产日期(必须 == 财年结束日)
    • 地址:主要营业地址,包含州缩写
    • 业务性质:从下拉菜单中选择(例如,“Technology/Software”)
    • 高级职员:名字/中间名/姓氏、职务、地址
    • 董事:设置总人数,点击 "Enter Directors Info",为每位董事填写名字/中间名/姓氏和地址
    • 授权人:名字/中间名/姓氏、职务、地址
    • 条款与条件复选框:继续前必须勾选 chkCertify
  5. 重新计算税款:点击 "Recalculate Tax" 按钮。确认显示的税款与第 2 阶段的计算结果一致。如果仍显示按 Authorized Shares 方法计算的金额,资产日期可能有误——通过 JavaScript 修正。
  6. 审核:点击 "Continue Filing" 查看审核副本。核对所有数据。
  7. 付款:点击 "Proceed to Payment"。Agent 必须在此处停止——信用卡和银行信息必须由用户输入。如果税款超过 $5,000,必须通过 ACH 付款。
  8. 确认:付款后:
    • 点击 "Display Confirmation Copy"(onclick="downloadConfirmation();return false;")保存收据 PDF
    • 点击 "Email Confirmation Copy",通过电子邮件发送已申报报告(会打开 Email.aspx 弹出窗口,输入电子邮件地址)
    • 重要:“离开此页面后,将无法再获取确认副本”——离开前先保存/发送电子邮件
    • 记录 URL 中的 Service Request Number:srNo=XXXXX

第 4 阶段:保存收据并设置提醒

保存确认 PDF

下载的确认 PDF 就是申报记录,无需另行创建。

门户会将收据下载为 Ecorp_Confirmation_<ServiceRequestNumber>.pdf,保存到默认的 Downloads 文件夹。将其移到可靠的存储位置:

  • 本地磁盘上的 ~/Documents/Tax/Delaware/<EntityName>/
  • 如果有云存储,则存入其中的“Tax”或“Corporate Records”文件夹
  • 保留原始文件名——其中包含 Service Request Number,便于日后查阅
# Example
mkdir -p ~/Documents/Tax/Delaware/My-Corp-Name
mv ~/Downloads/Ecorp_Confirmation_*.pdf ~/Documents/Tax/Delaware/My-Corp-Name/

询问用户将税务记录保存在哪里,并将文件移至该位置。

设置提醒

提醒用户每年在截止日期前约 2 周设置提醒:

  • 2 月中旬:公司(截止日期为 3 月 1 日)
  • 5 月中旬:LLC/LP/GP(截止日期为 6 月 1 日)

安排方式:

  • Claude Cowork:使用 /schedule 设置重复任务
  • Claude Code CLI:使用外部调度程序(cron、LaunchAgent)
  • 任意日历应用:设置每年重复的提醒
  • 如果有 ~~calendar MCP 可用,可直接创建提醒

参考资料

详细计算公式和官方指南见 reference/ 目录:

  • reference/tax-calculation.md — 两种方法的完整公式及示例
  • reference/filing-instructions.md — 费用、付款方式和截止日期
  • reference/faq.md — 常见问题
  • reference/ecorp-portal-playwright-notes.md — eCorp 门户的字段选择器、注意事项和自动化技巧

官方来源:https://corp.delaware.gov/paytaxes/ 帮助热线:302-739-3073,选项 3

注意事项

  • 此技能不提供税务建议——请就您的具体情况咨询税务专业人士。
  • 特拉华州公司事务部门户是唯一的官方申报方式。
  • 逾期申报将被处以 $200 罚款 + 每月 1.5% 的利息。
  • 如果特许经营税超过 $5,000,则必须通过 ACH 付款(超过此金额不接受信用卡)。
  • 大型企业申报者(在全国性证券交易所上市,且收入或资产达到 $750M+)需缴纳固定金额 $250,000。

连接器

如需了解可选 MCP 连接器(如日历、云存储)的设置,请参阅 CONNECTORS.md。

评论

支持 Markdown