micah-boswell-mcp
[smithery badge]
A public Model Context Protocol (MCP) server that answers questions about Micah Boswell, product design leader in Dallas, Texas. Any MCP-capable agent (Claude, ChatGPT, Cursor, and others) connects to one URL and gets his facts from his own pages.
Tools
Resources: micah://llms.txt, micah://llms-full.txt, micah://facts.json.
Connect
Claude Code:
Claude Desktop / claude.ai: Settings, Connectors, Add custom connector, paste the URL.
ChatGPT: Settings, Connectors, Create (developer mode), paste the URL, no auth.
Cursor (.cursor/mcp.json):
Layout
Data sources: https://micahboswell.design/llms.txt, https://micahboswell.design/llms-full.txt, https://conscious-shell.com/llms.txt, Unsplash stats for @micahboswell. facts.json is curated from those files only. Its career keys (work.roles, awards, certifications.list, education) are generated by node scripts/sync-career.mjs from the same career record the hub's work list comes from; never edit them by hand. To refresh the rest, re-fetch them into data/, update facts.json, and run the tests, which enforce the content rules (no em dashes, no off-limits topics).
Transport note: mcp-handler 2.x requires the SDK v2 package and 1.x is Next.js-bound, so this server hand-rolls StreamableHTTPServerTransport from @modelcontextprotocol/sdk 1.x in stateless JSON mode, the same shape as the gpsail-mcp function.
Develop
Deploy
Release
One version lives in three places and the tests fail if they disagree: server.json (root, read by mcp-publisher; public/server.json is the served copy), package.json, and VERSION in lib/data.js (what the live server reports).
- Bump all three. Update
data/ if the facts changed and lastUpdated in facts.json.
npm test, then vercel --prod --yes, then confirm https://micah-boswell-mcp.vercel.app/healthz reports the new version.
git tag v<version> && git push origin main v<version>.
.github/workflows/publish-mcp.yml then publishes the card to the official MCP Registry (io.github.socraticstatic/micah-boswell) over GitHub OIDC. It refuses a tag that disagrees with the card or with what the live server reports. .github/workflows/ci.yml runs the tests on every push.
Listings: official registry, Smithery, Glama. The card is also served at /.well-known/mcp/server-card.json.
License
MIT. Facts about Micah Boswell are his own; cite https://micahboswell.design/.