Skip to main content
Back to home
V
VantagePeers
Railway
Convex
One-click self-hosting

Self-host VantagePeers MCP on Railway
in under 10 minutes

Your agents. Your data. Your deployment. No subscription required.

Deploy on Railway

Why Railway

One-click deploy

Pre-configured template — no Dockerfile required, no YAML to write.

Automatic HTTPS

Railway provisions a TLS certificate and public URL on every deploy.

Env management built in

Set secrets once in the Railway dashboard. No .env files committed to git.

Redeploy on push

Connect your fork to Railway and every push to main redeploys in 90 seconds.

Setup in 4 steps

  1. Click Deploy

    Open the Railway template with the button above. Railway clones the repo and builds the image automatically.

  2. Provision Convex

    Create a free Convex account via our referral link below. Copy the deployment URL — you'll need it in step 3.

    Create free Convex account

  3. Set environment variables in both Railway and Convex

    Two layers, each with its own set. In Railway → Variables, add these 3 service vars:

    • NODE_ENVSet to: production
    • CONVEX_URL_INTERNALThe deployment URL from step 2 (https://….convex.cloud)
    • BEARER_SECRET_MASTERA long random string (32+ chars). Authenticates all MCP client requests.

    Then in Convex (dashboard → Settings → Environment Variables), set 3 backend vars: BEARER_SECRET_MASTER (same value as Railway), AI_GATEWAY_API_KEY for Vercel AI Gateway or OPENAI_API_KEY for direct OpenAI BYOK, and VP_LICENSE_KEY.

  4. Connect your MCP client

    Add the Railway URL to your Claude Code MCP config (claude_desktop_config.json or .claude.json). Set the Authorization header to "Bearer {BEARER_SECRET_MASTER}".

Verify the deployment

Once Railway finishes building, run this health check from your terminal:

terminal
curl https://your-deployment.railway.app/health

Expected response:

{
  "status": "ok",
  "version": "2.2.0",
  "timestamp": "2026-05-08T00:00:00.000Z"
}
Railway

Need a Railway account?

Railway is the hosting platform for the VantagePeers MCP server. The free plan is sufficient for most teams. Sign up via our referral link — it costs you nothing extra.

Create Railway account
Convex

Need a Convex account?

Convex is the real-time database powering VantagePeers. The free plan covers up to 1M function calls/month — enough for several active agent teams. Using our referral link costs you nothing extra.

Create Convex account (referral: LAUREN7583)

Also works in Claude.ai web

Claude.ai web connects via OAuth 2.1 DCR — paste your Railway URL in Settings → Integrations → Custom MCP servers. No bearer token, no config file. Full docs at vantagepeers.com/docs.

View Claude.ai web setup docs

Pricing

Self-hosting is free. No Railway subscription is required for low-traffic deployments (Railway free plan covers most dev teams). Optional paid support plans are available.

See pricing plans
Deploy on Railway