Arc & Ledger Tax Tools - MCP server

A public, no-auth remote MCP server that exposes Arc & Ledger's free tax calculators and intake funnel as tools inside AI assistants (Claude, ChatGPT). Runs as a stateless Cloudflare Worker; nothing is filed, purchased, or stored.

• Endpoint: https://mcp.arcandledger.com/mcp (Streamable HTTP)

• Docs: https://www.arcandledger.com/mcp

• Privacy: https://www.arcandledger.com/mcp/privacy

Tools

Plus five prompts (three English, two Turkish for founders): decode_my_irs_notice, am_i_required_to_file_fbar, should_i_be_an_scorp, abd_sirket_vergi_takvimi, itin_almali_miyim.

And four read-only resources (arcledger://office, arcledger://services, arcledger://fee-catalog, arcledger://tool-directory) so an assistant can cite the firm's identity, service directory, and fee catalog directly.

Related MCP server: DevHelm MCP Server

Design

• Stateless Streamable-HTTP JSON-RPC handler (no sessions, no Durable Objects). Uses the official @modelcontextprotocol/sdk types + zod.

• No hardcoded prices or rates. src/pricing.ts re-exports the published fee schedule in src/data/pricing.ts (same numbers as arcandledger.com/pricing/); src/rates.ts re-exports the 2026 tax constants in src/data/taxConstants2026.ts and adds only genuinely-new pieces (safe harbor, CA S-corp rate, Form 8938 matrix, CA 30/40/0/30). Both are the single sources of truth.

• Shared response envelope: every tool returns the same disclaimer, a first-party source_url, and one first-party next_step handoff.

• Privacy: inputs processed in memory; logs carry only tool name, timestamp, and coarse enums (never free text or dollar amounts). 30-day retention.

• Rate limiting: per-IP token bucket (60/min, burst 10) + the native RATE_LIMITER binding when bound.

Commands

npm install
npm test              # protocol, HTTP surface, tool correctness, resources, widget,
                      # determinism, schema-contract snapshot, content-governance gates
npm run typecheck
npm run dev           # wrangler dev (local)
npm run deploy        # wrangler deploy (needs the Cloudflare account)
npm run gen:products  # regenerate public/feeds/products.json from pricing.ts
node scripts/gen-examples.mjs      # regenerate docs/worked-examples.json

Layout

src/
  index.ts            Worker entry: /mcp, /healthz, /version, CORS, rate limit
  registry.ts         The 15 tools + 5 prompts
  pricing.ts          Adapter -> data/pricing.ts (SSOT for prices)
  rates.ts            Adapter -> data/taxConstants2026.ts + server-only tax constants
  lib/                mcp (protocol), response, logging, rateLimit, tax, dates, schemas
  tools/              one file per tool
  data/               pricing, tax constants, product catalog, service pages, IRS notices
submissions/          Anthropic + OpenAI payloads + listing copy
assets/               logo, favicon, response screenshots + paired prompts