How to Deploy MCP Server to Fly.io

An MCP server implements the Model Context Protocol, exposing tools for AI agents via Streamable HTTP or SSE. Fastio's hosted MCP server offers 251 tools for workspaces, but running your own lets you customize tools, integrate private data, or proxy to services like Fastio.

Fly.io suits MCP deployments because Machines start sub-second, scale horizontally, and run in multiple+ regions for low-latency agent calls. Volumes persist agent state across restarts, and secrets handle API keys securely. Developers report multiple-multiple% faster tool responses versus centralized servers.

Production MCP servers need persistence for sessions and low-latency routing. Fly.io handles this natively without VPCs or load balancers.

Helpful references: Fastio Workspaces, Fastio Collaboration, and Fastio AI.

Install flyctl from fly.io. Run these commands:

curl -L https://fly.io/install.sh | sh
flyctl auth signup  # or login if existing account

Dockerize your MCP server. Example Dockerfile for a Node.js MCP:

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
EXPOSE 8080
CMD ["node", "server.js"]

Tag and push: docker build -t your-registry/mcp-server . && docker push your-registry/mcp-server

Launch the app:

flyctl launch --name my-mcp-server --image your-registry/mcp-server:latest

Edit fly.toml:

app = "my-mcp-server"
primary_region = "iad"

[[services]]
  internal_port = 8080
  protocol = "tcp"

[[services.ports]]
    port = 443
    handlers = ["http"]

[[services.http_checks]]
    interval = "10s"
    grace_period = "5s"
    method = "GET"
    path = "/health"

Deploy: flyctl deploy

Build Agent Workspaces with Fastio MCP

Get 50GB free storage, 5,000 credits/month, 251 MCP tools. No credit card. Perfect complement to your Fly.io MCP deploy. Built for deploy mcp server flyio workflows.

Start Free Agent Plan

MCP servers store agent sessions and state. Attach Fly Volumes:

flyctl volumes create mcp-data --region iad --size 10
flyctl machine update <machine-id> --attach-volume mcp-data --volume-path /data

Update Dockerfile to use /data for persistence. Restart Machine: flyctl machine restart <machine-id>

Volumes replicate across multiple AZs by default, surviving Machine restarts. Scale to multiple GB+ for large agent fleets.

Store API keys and configs as secrets:

flyctl secrets set FASTIO_API_KEY=yourkey DATABASE_URL=postgres://...

Secrets inject as env vars on Machine boot. Access in code: process.env.FASTIO_API_KEY.

List: flyctl secrets list. Unset: flyctl secrets unset KEY.

Secrets encrypt at rest, decrypt only on host at boot.

Scale Machines: flyctl scale count 3 --region iad

Multi-region: flyctl regions add ord sin

Autoscaling: Add to fly.toml:

[http_service]
  auto_stop_machines = true
  auto_start_machines = true
  min_machines_running = 1

Monitor: flyctl logs, flyctl metrics. Set alerts via API.

For high-load MCP, use Machines API directly for dynamic scaling based on agent traffic.