Back to Wave Wiki

Wave MCP

From Wave Wiki — the open reference for the Wave OS ecosystem.

1. About

Wave MCP is an MCP (Model Context Protocol) server that connects AI coding tools like Cursor to the Wave OS backend. It exposes 28 tools for entity CRUD, file management, compute sessions, token operations, and more. Runs as a dual-mode Railway SSE proxy supporting both public access and authenticated user-specific requests via Bearer headers.

2. Tech Stack

Built with Node.js, deployed on Railway as an SSE (Server-Sent Events) proxy. Current version: v4.4.0. Endpoints: https://wave-mcp.up.railway.app/sse (Railway SSE proxy) and https://app.oswave.io/api/functions/mcpRouter (direct HTTP). Uses eager tool caching on startup to prevent race conditions. Dual-mode: handles both public access and authenticated requests via Authorization Bearer header forwarding. Requires WAVE_API_TOKEN for authenticated access. 28 tools covering entity CRUD, file operations, compute sessions, token launches, and more.

3. Install

For Cursor: Configure mcp.json with either Railway SSE (type: 'sse', url: 'https://wave-mcp.up.railway.app/sse') or direct HTTP (type: 'http', url: 'https://app.oswave.io/api/functions/mcpRouter', headers: Authorization Bearer WAVE_API_TOKEN). Installation docs at xbuildyteam.github.io/wave-mcp-proxy/install.html. Difficulty: Easy (copy config to Cursor settings).

4. Pricing & Credits

Free and open source. No Wave credits or TFUEL costs for the MCP proxy itself. Uses Railway free tier for hosting. API calls through the proxy consume Wave OS credits for operations that require them (compute sessions, AI generation).

5. Known Limitations & Roadmap

[PLACEHOLDER]

6. Privacy & Data

The MCP proxy does not store any data — it forwards requests to the Wave OS backend. Bearer tokens are passed through to the backend for authentication. No request logging beyond standard Railway platform logs. All data operations go through Wave OS row-level security. User-scoped queries prevent cross-account data access.

7. Published by

Published by xBuildy. GitHub repo: xBuildyTeam/wave-mcp-proxy. Created date: [PLACEHOLDER]. Version: v4.4.0.