Upvote.club — Remote MCP Server

Streamable HTTP MCP server for Claude.ai custom connectors.

Per Anthropic remote MCP docs: add https://YOUR-HOST/mcp in Settings → Connectors → Add custom connector, with X-API-Key request header (upv_...).

Run locally

cd upvote-club-mcp/remote
npm install
UPVOTE_API_KEY=upv_... npm start
# → http://localhost:8787/mcp
curl http://localhost:8787/health

Related MCP server: mcp-tool-builder

Test with tunnel

npx cloudflared tunnel --url http://localhost:8787
# Add the HTTPS URL + /mcp as custom connector in Claude.ai

Auth modes

1. Per-user (recommended): Claude sends X-API-Key: upv_... on every request (Request headers in connector settings).

2. Server default: Set UPVOTE_API_KEY env var on the host (single shared key — not for production multi-tenant).

Deploy (Heroku example)

cd upvote-club-mcp/remote
heroku create upvote-club-mcp --buildpack heroku/nodejs
git subtree push --prefix upvote-club-mcp/remote heroku main

Or deploy as a separate Heroku app pointing at this folder.

Environment

Tools

All 7 Public API tools — see ../docs/ENDPOINT_MAP.md.

Security

• Use HTTPS in production

• Prefer per-user X-API-Key headers over a shared env key

• Do not expose without TLS

Privacy

Proxies requests to https://api.upvote.club only. https://upvote.club/privacy-policy