This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Ship a remote MCP connector for Claude that is built to pass Anthropic's directory review on the first try.
This kit is the set of patterns Modern Mustard Seed uses for the connectors it runs in production, pulled out into a clean Next.js project you can fork:
A route template on Next.js App Router and mcp-handler, serving Streamable HTTP at one URL per connector, with no redirect.
Tool conventions enforced at load time: a title, readOnlyHint or destructiveHint on every tool, snake_case names of 64 characters or fewer, and descriptions that describe instead of steer. Break a rule and pnpm test fails, long before a reviewer sees it.
Specific error messages instead of "Bad Request", and output size caps under Claude's limits.
Rate limiting built for Claude's shared egress range. Every claude.ai user arrives from 160.79.104.0/21, so nothing is keyed by IP and nothing returns HTTP 429.
An SSRF-safe fetch for any tool that reads a URL a user supplied, with tests that prove a listening loopback server receives zero requests.
An eval harness that runs real prompts against your live URL, with no model and no API key.
Docs, privacy, terms and support page templates plus /.well-known/security.txt, all driven by one config file.
A submission checklist mapped to the directory form's 10 steps and its seven policy acknowledgments, with every rule linked to Anthropic's documentation.
A worked example: a U.S. federal holiday and business-day calendar with five read-only tools that passes all 35 of its own evals.
MIT licensed. Built by Modern Mustard Seed.
The example connector runs live, deployed from this repository with no changes:
Connector URL: https://starter.modernmustardseed.com/holidays (add it in Claude under Customize > Connectors > Add custom connector)
Docs page reviewers read: https://starter.modernmustardseed.com/docs/holidays
Privacy, terms and support: https://starter.modernmustardseed.com/privacy, /terms, /support
Official MCP Registry entry: com.modernmustardseed/holiday-calendar
Run the evals against it yourself: node eval/holidays.eval.mjs https://starter.modernmustardseed.com
Related MCP server: OpenWorkdays
You need Node 22.6 or later, pnpm, and a Vercel account (any host that runs Next.js works).
1. Make your copy. (1 minute)
gh repo create my-connector --template ModernMustardSeed/small-business-mcp-starter --public --clone
cd my-connector
pnpm installOr select Use this template on GitHub.
2. Run it and prove it works. (2 minutes)
pnpm devIn a second terminal:
pnpm test
pnpm evals http://localhost:3000You should see 32 pass from the unit tests and 35 of 35 passed from the evals. Open http://localhost:3000/docs/holidays to see the docs page reviewers read.
3. Make it yours. (2 minutes)
Edit lib/site.ts: company name, location, website, support inbox, security inbox, and the policy date. Every public page and security.txt read from it. Replace app/icon.svg and app/apple-icon.png with your own mark; the directory listing asks for an icon.
4. Deploy. (3 minutes)
Import the repository at vercel.com/new, or from the terminal:
vercel deploy --prodVercel sets VERCEL_PROJECT_PRODUCTION_URL, which the pages use for their links. Leave Attack Challenge Mode and any bot-protection rule off for your MCP paths: they answer Claude with a challenge page.
5. Check the deployment. (1 minute)
pnpm preflight https://your-project.vercel.app
pnpm evals https://your-project.vercel.app
npx @modelcontextprotocol/inspector --cli https://your-project.vercel.app/holidays --transport http --method tools/listPreflight checks HTTPS, no redirect, no 403 or 429, every public page returning 200, the MCP handshake and the annotation rules.
6. Try it in Claude. (1 minute)
In Claude, open Customize > Connectors > Add custom connector and paste https://your-project.vercel.app/holidays. Ask: "An invoice dated 2026-11-20 is due in 10 business days. What date is that?" In Claude Code:
claude mcp add --transport http holidays https://your-project.vercel.app/holidaysCopy lib/holidays/tools.ts to lib/<yours>/tools.ts. Declare each tool as a ToolSpec: name, title, description, zod input schema, annotations, a per-minute limit, optional global limits, the fields that are safe to log, and a run function that returns ok(data) or fail(code, sentence).
Copy app/holidays/route.ts to app/<yours>/route.ts and point it at your tools.
Copy app/docs/holidays/page.tsx to app/docs/<yours>/page.tsx. Keep the "For reviewers" section: you paste it into the form.
Rewrite app/privacy/page.tsx so every sentence is true of your tools: what they receive, what they read, what you keep and for how long, who else touches it.
Copy eval/holidays.eval.mjs. Write 20 to 50 cases from prompts real users type, with expected values from an authority outside your code. Include the error cases.
If a tool fetches a URL a user gave you, use safeFetch from lib/mcp/safe-fetch.ts. Never fetch a user-supplied URL directly.
Deploy, run pnpm preflight and pnpm evals against production, test every tool in Claude, then work through docs/SUBMISSION-CHECKLIST.md.
Why each pattern exists, with the rule it answers: docs/PATTERNS.md.
Path | What it does |
| The connector endpoint. One file per connector. |
|
|
| Per-instance and global limits, never by IP; Redis with an in-memory fallback; a small cache. |
| SSRF-safe fetch: public addresses only, guarded DNS lookup, five checked redirects, byte cap, deadline. |
| The example connector: the holiday engine and its five tools. |
| Company, support and security contacts, policy date. Edit first. |
| The pages reviewers and users open. |
| RFC 9116 security contact. |
| Dependency-free MCP client and the example's 35 checks against a live URL. |
| Pre-submission checks against a deployed URL. |
| Fails on em and en dashes in tracked files. |
| Unit tests for conventions, limits, SSRF guard and the example engine. |
| The submission checklist and the pattern notes. |
The example runs with no environment variables. Optional:
Variable | Purpose |
| Public origin, if you are not on Vercel or want a custom domain in page links. |
| Global rate limits and cache shared across instances. The Vercel Marketplace integration sets |
Command | What it does |
| Local server on port 3000. |
| Unit tests (Node's built-in runner). |
| The example's evals against a running server. |
| Pre-submission checks against a deployed URL. |
| The usual. |
| No em or en dashes in tracked files. |
The Holiday Calendar computes the eleven U.S. federal holidays from 5 U.S.C. 6103, a public-domain statute, with the observance rule federal offices follow: Saturday holidays move to the Friday before, Sunday holidays to the Monday after. It covers 2021 through 2100. Its tools list a year of holidays, find the next ones, check whether a date is a business day, add business days to a date, and count business days in a span. It makes no network calls and stores nothing. The evals check its answers against the Office of Personnel Management's published schedules.
Issues and pull requests are welcome; see CONTRIBUTING.md. Report vulnerabilities privately as described in SECURITY.md.
This kit is not affiliated with or endorsed by Anthropic. "Claude" is a trademark of Anthropic, PBC. Directory rules change; the checklist links every rule to Anthropic's documentation so you can confirm it before you submit.
This kit comes from Modern Mustard Seed, an AI studio in Kalispell, Montana that builds websites, AI voice agents and custom software for small businesses, managed for you, end to end.
MIT, Copyright (c) 2026 Modern Mustard Seed LLC.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
US federal holidays, business-day maths, invoice due dates and IRS deadlines.
Exact U.S. federal holidays and business days 1971-2100, OPM and Federal Reserve observance.
Count workdays, office days and PTO days, or list bank holidays and school breaks.
Count days between dates, add or subtract dates, and look up public holidays by country.
