# Ink MCP

MCP server for deploying and managing applications on [ml.ink](https://ml.ink).

```
Server URL: https://mcp.ml.ink/mcp
Transport:  Streamable HTTP
Auth:       OAuth 2.1 (PKCE) or API key
```

---

## Authentication

### OAuth

MCP clients that support OAuth handle the login flow automatically — add the server URL and sign in via browser.

### API Key

1. Sign up at [ml.ink](https://ml.ink)
2. **Settings** → **API Keys** → **Generate**
3. Pass via header: `Authorization: Bearer dk_live_...`

---

## Client Setup

### Claude Code

```bash
# OAuth
claude mcp add --transport http ink https://mcp.ml.ink/mcp

# API key
claude mcp add --transport http ink https://mcp.ml.ink/mcp \
  --header "Authorization: Bearer dk_live_YOUR_API_KEY"
```

### Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "ink": {
      "url": "https://mcp.ml.ink/mcp"
    }
  }
}
```

With API key:

```json
{
  "mcpServers": {
    "ink": {
      "url": "https://mcp.ml.ink/mcp",
      "headers": {
        "Authorization": "Bearer dk_live_YOUR_API_KEY"
      }
    }
  }
}
```

### Cursor

**Settings** → **MCP** → **Add new MCP server**:

```json
{
  "mcpServers": {
    "ink": {
      "url": "https://mcp.ml.ink/mcp"
    }
  }
}
```

### Windsurf

**Settings** → **MCP** → **Add Server**:

```json
{
  "mcpServers": {
    "ink": {
      "serverUrl": "https://mcp.ml.ink/mcp"
    }
  }
}
```

### Codex CLI

```bash
codex mcp add --transport http ink https://mcp.ml.ink/mcp \
  --header "Authorization: Bearer dk_live_YOUR_API_KEY"
```

### Cline / Roo Code

Add to extension MCP settings:

```json
{
  "mcpServers": {
    "ink": {
      "url": "https://mcp.ml.ink/mcp",
      "headers": {
        "Authorization": "Bearer dk_live_YOUR_API_KEY"
      }
    }
  }
}
```

---

## Tools

### Services

| Tool | Description |
|------|-------------|
| `create_service` | Deploy a service from a git repo |
| `list_services` | List deployed services |
| `get_service` | Service details, build/runtime logs |
| `update_service` | Update config (repo, branch, port, env, resources, commands) |
| `redeploy_service` | Redeploy with latest code |
| `delete_service` | Delete a service |

### Databases

| Tool | Description |
|------|-------------|
| `create_resource` | Provision a database (SQLite via Turso) |
| `list_resources` | List databases |
| `get_resource` | Connection details (URL + auth token) |
| `delete_resource` | Delete a database |

### Git

| Tool | Description |
|------|-------------|
| `create_repo` | Create a git repo (internal or GitHub) |
| `get_git_token` | Temporary push token |

### Custom Domains & DNS

| Tool | Description |
|------|-------------|
| `add_custom_domain` | Attach a custom domain to a service |
| `remove_custom_domain` | Remove a custom domain |
| `list_delegations` | List delegated zones |
| `add_dns_record` | Add DNS record (A/AAAA/CNAME/MX/TXT/CAA) |
| `delete_dns_record` | Remove a DNS record |
| `list_dns_records` | List records in a zone |

### Workspaces

| Tool | Description |
|------|-------------|
| `workspace_list` | List workspaces |
| `workspace_create` | Create a team workspace |
| `workspace_delete` | Delete a workspace |
| `workspace_invite` | Invite by email or git username |
| `workspace_accept_invite` | Accept invite |
| `workspace_decline_invite` | Decline invite |
| `workspace_revoke_invite` | Revoke invite |
| `workspace_remove_member` | Remove member |
| `workspace_list_members` | List members and roles |
| `workspace_list_invites` | List pending invites |

### Other

| Tool | Description |
|------|-------------|
| `list_projects` | List projects in a workspace |
| `account_status` | Account details, balance, GitHub App status |
| `chat` | Send/read workspace or project messages |
| `list_action_log` | Query audit log |

---

## Supported Frameworks

Auto-detected, no configuration needed:

- **JS/TS** — Next.js, Remix, SvelteKit, Nuxt, Astro, Express, Fastify, Hono
- **Python** — FastAPI, Flask, Django, Starlette
- **Go** — Any Go server
- **Rust** — Axum, Actix, Rocket
- **Ruby** — Rails, Sinatra
- **Static** — HTML/CSS/JS, Vite, CRA
- **Dockerfile** — Custom via `build_pack="dockerfile"`

---

## Links

- [ml.ink](https://ml.ink)
- [Documentation](https://docs.ml.ink)
- [Status](https://ink.instatus.com)

## License

MIT