# IOX Cloud MCP Server

The reference MCP (Model Context Protocol) server for [IOX Cloud](https://iox.cloud) — a platform that deploys MCP servers and AI agents to 300+ edge locations via Cloudflare Workers for Platforms.

This repository is a minimal, self-contained MCP server demonstrating the kind of workload IOX Cloud deploys on behalf of users. It implements the MCP 2025-03-26 protocol over HTTP and exposes four tools that introspect the IOX Cloud platform.

## Live Endpoint

Connect this MCP server to Claude Desktop, Cursor, or Windsurf:

```json
{
  "mcpServers": {
    "iox-cloud": {
      "url": "https://iox-dispatch.matt-merutech.workers.dev/mcp?worker=test-tenant"
    }
  }
}
```

## Tools

| Tool | Description |
|---|---|
| `get_platform_info` | Returns metadata about the IOX Cloud platform (regions, runtime, pricing, auth). |
| `list_templates` | Lists starter templates available for one-click deployment. |
| `estimate_cost` | Estimates monthly cost for a given request volume and CPU profile. |
| `check_slug_available` | Checks whether a subdomain is available at `{slug}.iox.cloud`. |

## Running Locally

```bash
node mcp-server.js
# → IOX Cloud MCP Demo server on port 3000
```

Test it:

```bash
curl -s -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"id":1,"method":"tools/list"}'
```

## Docker

```bash
docker build -t iox-cloud-mcp .
docker run -p 3000:3000 iox-cloud-mcp
```

## About IOX Cloud

IOX Cloud is an AI-native deployment platform for MCP servers and agents. You describe what you want in plain English, Claude writes the code, and we deploy it globally in seconds with per-tenant V8 isolation (same model Shopify uses for their apps).

- **Website**: https://iox.cloud
- **Docs**: https://iox.cloud/docs
- **MCP Registry**: `cloud.iox/iox-cloud`

## License

MIT — see [LICENSE](LICENSE).