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

Tool	What it does
list_allen_media	Lists Allen's patents (fetchable via get_patent) and his talk/demo videos with watch links.
get_patent	Fetches full patent detail — abstract, inventors, assignee, dates, claims — from Google Patents. Works for any US publication number; Allen's are US20250086403A1 and US20240303280A1. KV-cached 30 days.
send_contact_request	Logs a message to Allen (name, email, message, intent). Reviewed via the script below. Daily-capped.

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.