allenhoem-mcp

A remote Model Context Protocol server exposing tools that enrich Allen R. Hoem's professional record beyond what allenhoem.com hosts. Runs on Cloudflare Workers (Agents SDK McpAgent, Durable Object–backed) and is usable by any MCP client — Claude Desktop, ChatGPT, Slack — and by the allenhoem.com chat panel via Anthropic's MCP connector.

Live: https://allenhoem-mcp.allenhoem.workers.dev MCP endpoint (Streamable HTTP): https://allenhoem-mcp.allenhoem.workers.dev/mcp

Tools

Deferred: get_youtube_transcript

Code is in src/youtube.ts but the tool is not registered. YouTube's 2026 "poToken" gate makes reliable transcript extraction from a datacenter IP infeasible (verified: the timedtext endpoint returns an empty body without a poToken, even from a residential IP with a valid caption-track list). To enable later, pick one: pre-bake Allen's ~6 talk transcripts into KV, or wire a third-party transcript API and re-register the tool.

Connect a client

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "allenhoem": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://allenhoem-mcp.allenhoem.workers.dev/mcp"]
    }
  }
}

ChatGPT (Developer mode / connectors) or Slack (custom MCP integration): add the server URL https://allenhoem-mcp.allenhoem.workers.dev/mcp (Streamable HTTP). Some legacy clients need SSE — use /sse instead.

Anthropic API (how the website consumes it): pass the server in the request with beta mcp-client-2025-11-20:

"mcp_servers": [{ "type": "url", "url": ".../mcp", "name": "allenhoem" }],
"tools": [{ "type": "mcp_toolset", "mcp_server_name": "allenhoem" }]

Review contact requests

./scripts/contacts.sh

Or enable the authed HTTP view: npx wrangler secret put ADMIN_TOKEN, then GET https://allenhoem-mcp.allenhoem.workers.dev/admin/contacts?token=<token>.

Tool-use logging

Every tool call increments toolcount:<date>:<tool> and writes a toollog:<ts> record (90-day TTL) in the MCP_CACHE KV namespace. Inspect with:

npx wrangler kv key list --namespace-id 2bc85e810484488eb740611f403c6a85 --remote | grep toolcount

Develop & deploy

npm install
npm run typecheck
npx wrangler kv namespace create MCP_CACHE   # first time — paste id into wrangler.jsonc
npm run deploy

Local dev: npm run dev, then point test-client.mjs at http://localhost:8787/mcp.