Gyro MCP server

Model Context Protocol server for Gyro Hosting. AI assistants (Claude, Cursor, VS Code, any MCP client) can search the Gyro developer docs and manage your Gyro cloud with your own API key: cloud servers, containers (ECS), S3 object storage, DNS, billing.

{
  "mcpServers": {
    "gyro": {
      "command": "npx",
      "args": ["-y", "@gyro-hosting/mcp"],
      "env": { "GYRO_TOKEN": "wck_..." }
    }
  }
}

Claude Code: claude mcp add gyro --env GYRO_TOKEN=wck_... -- npx -y @gyro-hosting/mcp

Create the key in the client area → account menu → API Credentials. Start with read scopes. Without a key only the docs tools work.

Tools

Related MCP server: @vertracloud/mcp

Safety

• Every call uses your key and sees only your account. The key is never logged or returned; secret fields are masked unless reveal_secrets is set.

• Tools that change something do nothing without confirm: true. Order tools return a price quote (dry run) first; real orders send an Idempotency-Key (derived from the arguments, so a retry never orders twice).

• API results are wrapped as untrusted data: names, logs and messages may contain text written by others; assistants are told never to follow instructions inside them.

Hosted remote endpoint

Gyro runs this server for you at https://mcp.gyrohosting.com/mcp (Streamable HTTP, stateless). No install needed:

{ "mcpServers": { "gyro": { "type": "http", "url": "https://mcp.gyrohosting.com/mcp", "headers": { "Authorization": "Bearer wck_..." } } } }

Claude Code: claude mcp add --transport http gyro https://mcp.gyrohosting.com/mcp --header "Authorization: Bearer wck_..."

Without the header only the docs tools work. If your API key is locked to IP addresses, also allow the endpoint's outgoing addresses 45.87.174.151, 45.87.174.153, 45.87.174.154. Limits: about 120 requests per minute per key, 256 KB per request.

Remote mode (self-hosted)

gyro-mcp --http --port 8787 serves stateless Streamable HTTP on /mcp. Each request brings its own Authorization: Bearer wck_…; a new server instance is built per request, so nothing is shared between keys. Per-key and per-IP rate limits; browser Origins are refused unless listed in GYRO_MCP_ORIGINS. Run it behind TLS (--trust-proxy to read the client IP from the proxy).

Environment: GYRO_TOKEN (or GYRO_API_KEY), GYRO_API_URL (default https://www.gyrohosting.com/api/v1/client), GYRO_DOCS_URL (default https://www.gyrohosting.com/developers).

Docs: https://www.gyrohosting.com/developers/en/mcp.html · Türkçe: https://www.gyrohosting.com/developers/tr/mcp.html

License: MPL-2.0