Skip to main content
Glama
eidos-agi
by eidos-agi

railguey-mcp-cloudflare

Railguey in the cloud. A Cloudflare Worker MCP server that bridges Grok to Railway GraphQL.

The CLI lives in eidos-agi/railguey. This repo is the hosted Streamable HTTP MCP that Grok can actually add as a connector — Railway’s own MCP (mcp.railway.com) is OAuth/CLI-shaped and cannot be added to Grok directly.

Live worker: railguey.eidos-agi.workers.dev

MCP: https://railguey.eidos-agi.workers.dev/mcp

Product page: eidosagi.com/tools/railguey

Why a separate repo

Repo

What it is

eidos-agi/railguey

Project-scoped Railway CLI (Go). Local shells, GitHub Actions, agents with a workspace path.

eidos-agi/railguey-mcp-cloudflare

Hosted MCP server (this Worker). Grok talks HTTP here; the Worker talks Railway GraphQL.

The Worker script is still named railguey on Cloudflare. That name is the workers.dev host and must match wrangler.toml name. The GitHub repo is named for what it is.

Related MCP server: @crisog/railway-mcp-server

Pairing (claim codes)

Railway tokens never go through Grok chat. Pairing is a device-code flow:

  1. Grok calls account_pair_begin (or a code is minted here).

  2. You open /pair/<CODE> on this worker.

  3. Paste a Railway token and give the account a slug (eidos, personal, client-acme).

  4. The worker validates the token against Railway, stores it in KV, and Grok sees it via account_list.

Codes expire in 10 minutes, are single-use, and burn after 8 failed pastes.

Account tokens (railway.com/account/tokens), workspace tokens, and project tokens (Project → Settings → Tokens) are all accepted. Kind is recorded so Grok knows the scope.

Multiple accounts

Each pair is a named slot. Railway tools take an optional account slug. One slot is the default.

This matches the CLI model (~/.railguey/accounts.json) — named accounts, one default — stored in Workers KV instead of a home directory.

Endpoints

  • GET / — status page

  • GET /health — JSON health (no secrets; includes paired account metadata)

  • GET /pair — enter a claim code

  • GET|POST /pair/:code — paste a Railway token

  • POST /mcp — MCP Streamable HTTP (auth required)

Secrets and bindings

  • MCP_AUTH_TOKEN — bearer Grok sends as Authorization: Bearer …

  • KV ACCOUNTS (railguey-accounts) — paired Railway tokens, claim codes, default slug

Never commit tokens. wrangler.toml only has the KV namespace id and Cloudflare account id.

Connect in Grok

  1. grok.com/connectors → Add connector → Other

  2. Server URL: https://railguey.eidos-agi.workers.dev/mcp

  3. Header: Authorization: Bearer <MCP_AUTH_TOKEN>

  4. Ask Grok to pair a Railway account, then open the claim URL it returns

Deploy

git push to main is the deploy. This repo is permanently attached to the live Worker:

  1. Push to eidos-agi/railguey-mcp-cloudflare main (especially index.js).

  2. Grok automation railguey-git-deploy fires on that push, uploads index.js to Worker railguey, and keeps KV + MCP_AUTH_TOKEN.

  3. Hourly backup redeploys main if a push event is missed.

No Cloudflare API token in GitHub. No Cloudflare GitHub App. Changing MCP behavior means editing index.js and pushing.

loader.js is a Dynamic Worker Loader (git-pull at the edge). It is not live — this Cloudflare account is on the free Workers plan (API 10195). wrangler.toml main stays index.js.

name = "railguey" must not change. Renaming the Worker would break the live host and Grok’s connector URL.

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables comprehensive management of Railway infrastructure, including projects, services, variables, and deployments, directly through the Railway GraphQL API. It is designed to work as a remote service over HTTP, allowing seamless integration with cloud-based MCP clients like claude.ai.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Unofficial MCP server for Railway that enables managing Railway infrastructure through natural language, including projects, services, deployments, environments, variables, templates, domains, volumes, observability, integrations, networking, and workflows.
    64 npm
    2
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that exposes the Railway API as tools for Claude. Manage Railway projects, services, deployments, variables, environments, and domains directly from Claude.
    16 npm
    MIT
  • F
    license
    B
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that gives Claude (and other MCP-compatible AI tools) full access to your Railway.app infrastructure. Deploy, manage services, check logs, configure environment variables — all through natural conversation.
    30
    10 npm
    -