explaingit

upvoteclub/upvote-club-mcp-remote

Analysis updated 2026-05-18

43JavaScriptAudience · developerComplexity · 2/5Setup · moderate

TLDR

A remote MCP server that lets Claude.ai connect to Upvote.club over HTTPS as a custom connector.

Mindmap

mindmap
  root((upvote-club-mcp-remote))
    What it does
      Streamable HTTP MCP server
      Claude.ai custom connector
      Health check endpoint
    Tech stack
      JavaScript
      Node.js
      Cloudflare Tunnel
      Heroku
    Use cases
      Host connector for Claude.ai
      Per-user API keys
      Deploy to Heroku
    Audience
      Developers
      MCP integrators
    Related packages
      Core library
      Local stdio
      Apps UI

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Host an Upvote.club connector that Claude.ai can reach directly over HTTPS.

USE CASE 2

Let multiple users connect to Upvote.club from Claude.ai, each with their own API key.

USE CASE 3

Deploy a Streamable HTTP MCP server to a platform like Heroku.

What is it built with?

JavaScriptNode.jsMCPCloudflare TunnelHeroku

How does it compare?

upvoteclub/upvote-club-mcp-remoteearthtojake/implicit.jsjavlonbek1233/amaliy-ish
Stars434343
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasyeasy
Complexity2/53/52/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs HTTPS hosting, or a Cloudflare Tunnel for testing, plus an Upvote API key.

In plain English

upvote-club-mcp-remote is a server that lets Claude.ai connect to Upvote.club as a custom connector over the internet, using a protocol called Streamable HTTP. Instead of running on a person's own machine and talking to Claude Desktop through stdio, like some of its sibling packages, this one is meant to be hosted somewhere reachable, so Claude.ai in the browser can reach it directly. This repo is one of five in the Upvote Club MCP family. A core package holds the shared library of six tools all the others depend on. A local package runs over stdio for Cursor, Claude Code, or Claude Desktop. An MCPB package is a single-click installer for Claude Desktop. An Apps package adds an inline progress bar card for task status. This repo, the Remote package, is built specifically for Claude.ai's custom connector feature, which needs an HTTPS endpoint. To run it, a person clones the repo, installs dependencies with npm, sets an Upvote API key, and starts the server, which listens on a local port and exposes a health check endpoint. For testing without deploying anywhere, a Cloudflare Tunnel can expose the local server temporarily with a public HTTPS address. For real use, the README gives an example of deploying to Heroku with a couple of commands. Authentication can work two ways: Claude can send a per-user API key with every request, which the README recommends, or the server can fall back to a single shared key set as an environment variable, meant only for testing rather than serving multiple users. A handful of environment variables control the port, bind address, and backend API URL. The security notes in the README stress using HTTPS in production, preferring the per-user API key approach, and never exposing the server without TLS. It connects only to Upvote.club's own API and links to a public privacy policy. The README does not state a license.

Copy-paste prompts

Prompt 1
Help me deploy this MCP server to Heroku so Claude.ai can connect to it.
Prompt 2
Set up a Cloudflare Tunnel so I can test this MCP server as a Claude.ai custom connector.
Prompt 3
Explain the difference between per-user API keys and the shared server default key in this project.
Prompt 4
Walk me through the environment variables this server needs to run in production.

Frequently asked questions

What is upvote-club-mcp-remote?

A remote MCP server that lets Claude.ai connect to Upvote.club over HTTPS as a custom connector.

What language is upvote-club-mcp-remote written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, MCP.

How hard is upvote-club-mcp-remote to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is upvote-club-mcp-remote for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.