@sota-io/mcp 1.0.0

package/README.md

@@ -0,0 +1,295 @@
+# @sota-io/mcp
+
+MCP server for [sota.io](https://sota.io) — deploy web apps via AI agents.
+
+[![npm](https://img.shields.io/npm/v/@sota-io/mcp)](https://www.npmjs.com/package/@sota-io/mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Node](https://img.shields.io/badge/node-%3E%3D20-green)](https://nodejs.org)
+
+## Quick Start
+
+1. Get an API key from [sota.io/dashboard/settings](https://sota.io/dashboard/settings)
+2. [Configure your IDE](#configuration)
+3. Ask your AI: *"Deploy my app to sota.io"*
+
+## Installation
+
+**No install needed** — run directly with npx:
+
+```bash
+npx -y @sota-io/mcp
+```
+
+Or install globally:
+
+```bash
+npm install -g @sota-io/mcp
+sota-mcp
+```
+
+## Configuration
+
+### Claude Code
+
+**CLI method:**
+
+```bash
+claude mcp add sota -- npx -y @sota-io/mcp
+```
+
+Then set your API key in the shell environment:
+
+```bash
+export SOTA_API_KEY=sota_your_api_key_here
+```
+
+**Manual JSON** (`.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "sota": {
+      "command": "npx",
+      "args": ["-y", "@sota-io/mcp"],
+      "env": {
+        "SOTA_API_KEY": "sota_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Edit `claude_desktop_config.json`:
+
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "sota": {
+      "command": "npx",
+      "args": ["-y", "@sota-io/mcp"],
+      "env": {
+        "SOTA_API_KEY": "sota_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Create `.cursor/mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "sota": {
+      "command": "npx",
+      "args": ["-y", "@sota-io/mcp"],
+      "env": {
+        "SOTA_API_KEY": "sota_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### Windsurf
+
+Edit `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "sota": {
+      "command": "npx",
+      "args": ["-y", "@sota-io/mcp"],
+      "env": {
+        "SOTA_API_KEY": "sota_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description | Parameters |
+|------|-------------|------------|
+| `deploy` | Deploy an app | `project_id`, `directory?` |
+| `get-logs` | Get build/runtime logs | `project_id`, `deployment_id?` |
+| `set-env` | Set environment variable | `project_id`, `key`, `value` |
+| `get-env` | List environment variables | `project_id` |
+| `rollback` | Rollback to previous deployment | `project_id` |
+| `get-status` | Get deployment status | `project_id` |
+| `list-projects` | List all projects | *(none)* |
+| `create-project` | Create a new project | `name` |
+
+### `deploy`
+
+Deploy an application to sota.io. Creates a tar.gz archive of the specified directory and uploads it.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_id` | string | Yes | Project ID to deploy to |
+| `directory` | string | No | Directory to deploy (defaults to current working directory) |
+
+```
+"Deploy my app in the current directory to sota.io"
+```
+
+### `get-logs`
+
+Get build and runtime logs for a deployment. If no deployment_id is provided, returns logs for the latest deployment.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_id` | string | Yes | Project ID to get logs for |
+| `deployment_id` | string | No | Specific deployment ID (defaults to latest) |
+
+```
+"Show me the build logs for my sota.io project"
+```
+
+### `set-env`
+
+Set an environment variable for a project.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_id` | string | Yes | Project ID |
+| `key` | string | Yes | Environment variable name (e.g., DATABASE_URL) |
+| `value` | string | Yes | Environment variable value |
+
+```
+"Set DATABASE_URL on my project to postgres://localhost/mydb"
+```
+
+### `get-env`
+
+List environment variables for a project.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_id` | string | Yes | Project ID |
+
+```
+"Show all environment variables for my project"
+```
+
+### `rollback`
+
+Rollback a project to its previous deployment. This swaps the container image without rebuilding.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_id` | string | Yes | Project ID to rollback |
+
+```
+"Roll back my app to the previous version"
+```
+
+### `get-status`
+
+Get the current deployment status for a project, including URL and recent deployment history.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_id` | string | Yes | Project ID to check status for |
+
+```
+"What's the status of my sota.io deployment?"
+```
+
+### `list-projects`
+
+List all projects on your sota.io account.
+
+*No parameters required.*
+
+```
+"List my sota.io projects"
+```
+
+### `create-project`
+
+Create a new project on sota.io.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `name` | string | Yes | Name for the new project |
+
+```
+"Create a new sota.io project called my-api"
+```
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `SOTA_API_KEY` | Yes | — | API key with `sota_` prefix. Create at [sota.io/dashboard/settings](https://sota.io/dashboard/settings) |
+| `SOTA_API_URL` | No | `https://api.sota.io` | API base URL |
+
+## Troubleshooting
+
+### "npx: command not found"
+
+**Problem:** Your IDE doesn't inherit the shell PATH where nvm/fnm is loaded.
+
+**Fix:** Use the absolute path to npx. Find it with:
+
+```bash
+which npx
+# Example output: /Users/you/.nvm/versions/node/v22.0.0/bin/npx
+```
+
+Then update your MCP config to use the absolute path:
+
+```json
+{
+  "mcpServers": {
+    "sota": {
+      "command": "/Users/you/.nvm/versions/node/v22.0.0/bin/npx",
+      "args": ["-y", "@sota-io/mcp"],
+      "env": {
+        "SOTA_API_KEY": "sota_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### "SOTA_API_KEY environment variable is required"
+
+**Problem:** The API key is not set in your MCP configuration.
+
+**Fix:** Add the `env` block to your MCP server config. Shell environment variables do **not** automatically pass to MCP servers — the `env` block in the config is required:
+
+```json
+{
+  "env": {
+    "SOTA_API_KEY": "sota_your_api_key_here"
+  }
+}
+```
+
+### Connection refused or timeout errors
+
+**Problem:** Network issue or wrong API URL.
+
+**Fix:** Check your internet connection. If you're using a custom API URL, verify `SOTA_API_URL` is set correctly. The default is `https://api.sota.io`.
+
+## License
+
+MIT
+
+## Links
+
+- [Website](https://sota.io)
+- [Documentation](https://sota.io/docs/mcp)
+- [Dashboard](https://sota.io/dashboard)
+- [Issues](https://github.com/sota-io/mcp/issues)

package/dist/api-client.d.ts

@@ -0,0 +1,49 @@
+/**
+ * HTTP client for the sota.io REST API.
+ * Used by MCP tools to interact with the platform.
+ */
+export interface Project {
+    id: string;
+    user_id: string;
+    name: string;
+    slug: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface Deployment {
+    id: string;
+    project_id: string;
+    status: string;
+    url?: string;
+    image_tag?: string;
+    build_method?: string;
+    framework?: string;
+    error?: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface EnvVar {
+    id: string;
+    project_id: string;
+    key: string;
+    value?: string;
+    created_at: string;
+    updated_at: string;
+}
+export declare class SotaAPIClient {
+    private baseURL;
+    private apiKey;
+    constructor(baseURL: string, apiKey: string);
+    private request;
+    listProjects(): Promise<Project[]>;
+    createProject(name: string): Promise<Project>;
+    deploy(projectId: string, archiveBuffer: Buffer): Promise<Deployment>;
+    rollback(projectId: string): Promise<Deployment>;
+    getDeployments(projectId: string): Promise<Deployment[]>;
+    getLogs(projectId: string, deploymentId: string): Promise<string>;
+    setEnvVar(projectId: string, key: string, value: string): Promise<void>;
+    listEnvVars(projectId: string): Promise<EnvVar[]>;
+    deleteEnvVar(projectId: string, key: string): Promise<void>;
+    deleteProject(projectId: string): Promise<void>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAqBD,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;YAK7B,OAAO;IAoBf,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAKlC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiCrE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKhD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAKxD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBjE,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKjD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAatD"}

package/dist/api-client.js

@@ -0,0 +1,105 @@
+/**
+ * HTTP client for the sota.io REST API.
+ * Used by MCP tools to interact with the platform.
+ */
+export class SotaAPIClient {
+    baseURL;
+    apiKey;
+    constructor(baseURL, apiKey) {
+        this.baseURL = baseURL.replace(/\/$/, '');
+        this.apiKey = apiKey;
+    }
+    async request(method, path, body) {
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+            'Content-Type': 'application/json',
+        };
+        const response = await fetch(`${this.baseURL}${path}`, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const errorBody = await response.json();
+            throw new Error(`API error: ${errorBody.error?.message || response.statusText}`);
+        }
+        return response.json();
+    }
+    async listProjects() {
+        const resp = await this.request('GET', '/v1/projects?limit=100');
+        return resp.data;
+    }
+    async createProject(name) {
+        const resp = await this.request('POST', '/v1/projects', { name });
+        return resp.data;
+    }
+    async deploy(projectId, archiveBuffer) {
+        const boundary = '----SotaMCPBoundary' + Date.now();
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+            'Content-Type': `multipart/form-data; boundary=${boundary}`,
+        };
+        const bodyParts = [
+            `--${boundary}\r\n`,
+            `Content-Disposition: form-data; name="archive"; filename="archive.tar.gz"\r\n`,
+            `Content-Type: application/gzip\r\n`,
+            `\r\n`,
+        ];
+        const prefix = Buffer.from(bodyParts.join(''));
+        const suffix = Buffer.from(`\r\n--${boundary}--\r\n`);
+        const body = Buffer.concat([prefix, archiveBuffer, suffix]);
+        const response = await fetch(`${this.baseURL}/v1/projects/${projectId}/deploy`, {
+            method: 'POST',
+            headers,
+            body,
+        });
+        if (!response.ok) {
+            const errorBody = await response.json();
+            throw new Error(`Deploy failed: ${errorBody.error?.message || response.statusText}`);
+        }
+        const resp = await response.json();
+        return resp.data;
+    }
+    async rollback(projectId) {
+        const resp = await this.request('POST', `/v1/projects/${projectId}/rollback`);
+        return resp.data;
+    }
+    async getDeployments(projectId) {
+        const resp = await this.request('GET', `/v1/projects/${projectId}/deployments`);
+        return resp.data;
+    }
+    async getLogs(projectId, deploymentId) {
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+        };
+        const response = await fetch(`${this.baseURL}/v1/projects/${projectId}/deployments/${deploymentId}/logs`, { headers });
+        if (!response.ok) {
+            throw new Error(`Failed to get logs: ${response.statusText}`);
+        }
+        return response.text();
+    }
+    async setEnvVar(projectId, key, value) {
+        await this.request('POST', `/v1/projects/${projectId}/envs`, { key, value });
+    }
+    async listEnvVars(projectId) {
+        const resp = await this.request('GET', `/v1/projects/${projectId}/envs`);
+        return resp.data;
+    }
+    async deleteEnvVar(projectId, key) {
+        await this.request('DELETE', `/v1/projects/${projectId}/envs/${key}`);
+    }
+    async deleteProject(projectId) {
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+        };
+        const response = await fetch(`${this.baseURL}/v1/projects/${projectId}`, {
+            method: 'DELETE',
+            headers,
+        });
+        if (!response.ok) {
+            const body = await response.json().catch(() => ({ error: { message: response.statusText } }));
+            throw new Error(`Delete failed: ${body.error?.message || response.statusText}`);
+        }
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * sota.io MCP Server
+ *
+ * Exposes all sota.io platform operations as MCP tools for AI agents
+ * (Claude Code, Open CLAW, etc.)
+ *
+ * Environment variables:
+ *   SOTA_API_KEY  - API key for authentication (sota_... prefix)
+ *   SOTA_API_URL  - API base URL (default: https://api.sota.io)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}

package/dist/index.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * sota.io MCP Server
+ *
+ * Exposes all sota.io platform operations as MCP tools for AI agents
+ * (Claude Code, Open CLAW, etc.)
+ *
+ * Environment variables:
+ *   SOTA_API_KEY  - API key for authentication (sota_... prefix)
+ *   SOTA_API_URL  - API base URL (default: https://api.sota.io)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { SotaAPIClient } from './api-client.js';
+import { registerProjectTools } from './tools/projects.js';
+import { registerDeployTool } from './tools/deploy.js';
+import { registerLogsTool } from './tools/logs.js';
+import { registerEnvTools } from './tools/env.js';
+import { registerRollbackTool } from './tools/rollback.js';
+import { registerStatusTool } from './tools/status.js';
+async function main() {
+    const apiKey = process.env.SOTA_API_KEY;
+    if (!apiKey) {
+        console.error('Error: SOTA_API_KEY environment variable is required');
+        console.error('Create one at: https://api.sota.io/v1/api-keys (or via sota CLI)');
+        process.exit(1);
+    }
+    const apiURL = process.env.SOTA_API_URL || 'https://api.sota.io';
+    const client = new SotaAPIClient(apiURL, apiKey);
+    const server = new McpServer({
+        name: 'sota',
+        version: '1.0.0',
+    });
+    // Register all tools
+    registerProjectTools(server, client);
+    registerDeployTool(server, client);
+    registerLogsTool(server, client);
+    registerEnvTools(server, client);
+    registerRollbackTool(server, client);
+    registerStatusTool(server, client);
+    // Start stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACtE,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,qBAAqB,CAAC;IAEjE,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,qBAAqB;IACrB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC,wBAAwB;IACxB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/deploy.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SotaAPIClient } from '../api-client.js';
+export declare function registerDeployTool(server: McpServer, client: SotaAPIClient): void;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/tools/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/tools/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,QAwD1E"}

package/dist/tools/deploy.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import { execSync } from 'child_process';
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+export function registerDeployTool(server, client) {
+    server.registerTool('deploy', {
+        description: 'Deploy an application to sota.io. Creates a tar.gz archive of the specified directory and uploads it.',
+        inputSchema: {
+            project_id: z.string().describe('Project ID to deploy to'),
+            directory: z.string().optional().describe('Directory to deploy (defaults to current working directory)'),
+        },
+    }, async ({ project_id, directory }) => {
+        const dir = directory ? resolve(directory) : process.cwd();
+        if (!existsSync(dir)) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: Directory not found: ${dir}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            // Create tar.gz archive using system tar (excludes common ignores)
+            const archivePath = `/tmp/sota-deploy-${Date.now()}.tar.gz`;
+            execSync(`tar -czf ${archivePath} --exclude='.git' --exclude='node_modules' --exclude='.env' --exclude='.DS_Store' -C ${dir} .`, { stdio: 'pipe' });
+            const { readFileSync, unlinkSync } = await import('fs');
+            const archiveBuffer = readFileSync(archivePath);
+            unlinkSync(archivePath);
+            const deployment = await client.deploy(project_id, archiveBuffer);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Deployment started:\n  ID: ${deployment.id}\n  Status: ${deployment.status}\n  URL: ${deployment.url || 'pending'}\n\nUse get-logs to check build progress.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Deploy failed: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=deploy.js.map

package/dist/tools/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/tools/deploy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAqB;IACzE,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE;QAC5B,WAAW,EAAE,uGAAuG;QACpH,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YAC1D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;SACzG;KACF,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAE3D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,+BAA+B,GAAG,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,mEAAmE;YACnE,MAAM,WAAW,GAAG,oBAAoB,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC;YAC5D,QAAQ,CACN,YAAY,WAAW,wFAAwF,GAAG,IAAI,EACtH,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAC;YAEF,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACxD,MAAM,aAAa,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;YAChD,UAAU,CAAC,WAAW,CAAC,CAAC;YAExB,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YAElE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,8BAA8B,UAAU,CAAC,EAAE,eAAe,UAAU,CAAC,MAAM,YAAY,UAAU,CAAC,GAAG,IAAI,SAAS,2CAA2C;qBACpK;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,kBAAkB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACjF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/env.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SotaAPIClient } from '../api-client.js';
+export declare function registerEnvTools(server: McpServer, client: SotaAPIClient): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/tools/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/tools/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,QAwExE"}

package/dist/tools/env.js

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+export function registerEnvTools(server, client) {
+    server.registerTool('set-env', {
+        description: 'Set an environment variable for a project',
+        inputSchema: {
+            project_id: z.string().describe('Project ID'),
+            key: z.string().describe('Environment variable name (e.g., DATABASE_URL)'),
+            value: z.string().describe('Environment variable value'),
+        },
+    }, async ({ project_id, key, value }) => {
+        try {
+            await client.setEnvVar(project_id, key, value);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Environment variable ${key} set successfully.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to set env var: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool('get-env', {
+        description: 'List environment variables for a project',
+        inputSchema: {
+            project_id: z.string().describe('Project ID'),
+        },
+    }, async ({ project_id }) => {
+        try {
+            const envVars = await client.listEnvVars(project_id);
+            if (envVars.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No environment variables set.',
+                        },
+                    ],
+                };
+            }
+            const lines = envVars.map((ev) => `${ev.key}=${ev.value || '****'}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Environment variables:\n${lines.join('\n')}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to list env vars: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=env.js.map

package/dist/tools/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/tools/env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAqB;IACvE,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE;QAC7B,WAAW,EAAE,2CAA2C;QACxD,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC7C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YAC1E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;SACzD;KACF,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC/C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,wBAAwB,GAAG,oBAAoB;qBACtD;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACzF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE;QAC7B,WAAW,EAAE,0CAA0C;QACvD,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;SAC9C;KACF,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YACrD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,+BAA+B;yBACtC;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC;YACrE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,2BAA2B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBACpD;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC3F;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/logs.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SotaAPIClient } from '../api-client.js';
+export declare function registerLogsTool(server: McpServer, client: SotaAPIClient): void;
+//# sourceMappingURL=logs.d.ts.map

package/dist/tools/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/tools/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,QAiDxE"}

package/dist/tools/logs.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+export function registerLogsTool(server, client) {
+    server.registerTool('get-logs', {
+        description: 'Get build and runtime logs for a deployment. If no deployment_id is provided, returns logs for the latest deployment.',
+        inputSchema: {
+            project_id: z.string().describe('Project ID to get logs for'),
+            deployment_id: z.string().optional().describe('Specific deployment ID (optional, defaults to latest)'),
+        },
+    }, async ({ project_id, deployment_id }) => {
+        try {
+            let deployId = deployment_id;
+            if (!deployId) {
+                // Get latest deployment
+                const deployments = await client.getDeployments(project_id);
+                if (deployments.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'No deployments found for this project.',
+                            },
+                        ],
+                    };
+                }
+                deployId = deployments[0].id;
+            }
+            const logs = await client.getLogs(project_id, deployId);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: logs || 'No logs available yet.',
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get logs: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=logs.js.map

package/dist/tools/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/tools/logs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAqB;IACvE,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE;QAC9B,WAAW,EAAE,uHAAuH;QACpI,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAC7D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;SACvG;KACF,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,EAAE,EAAE;QACzC,IAAI,CAAC;YACH,IAAI,QAAQ,GAAG,aAAa,CAAC;YAE7B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,wBAAwB;gBACxB,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;gBAC5D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC7B,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAe;gCACrB,IAAI,EAAE,wCAAwC;6BAC/C;yBACF;qBACF,CAAC;gBACJ,CAAC;gBACD,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAExD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,IAAI,wBAAwB;qBACvC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACtF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/projects.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SotaAPIClient } from '../api-client.js';
+export declare function registerProjectTools(server: McpServer, client: SotaAPIClient): void;
+//# sourceMappingURL=projects.d.ts.map

package/dist/tools/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,QAiE5E"}

package/dist/tools/projects.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+export function registerProjectTools(server, client) {
+    server.registerTool('list-projects', {
+        description: 'List all projects on your sota.io account',
+    }, async () => {
+        const projects = await client.listProjects();
+        const lines = projects.map((p) => `${p.name} (${p.slug}) - ID: ${p.id}`);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: projects.length === 0
+                        ? 'No projects found. Use create-project to create one.'
+                        : `Projects:\n${lines.join('\n')}`,
+                },
+            ],
+        };
+    });
+    server.registerTool('create-project', {
+        description: 'Create a new project on sota.io',
+        inputSchema: {
+            name: z.string().describe('Name for the new project'),
+        },
+    }, async ({ name }) => {
+        const project = await client.createProject(name);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Project created:\n  Name: ${project.name}\n  Slug: ${project.slug}\n  ID: ${project.id}\n  URL: https://${project.slug}.sota.io`,
+                },
+            ],
+        };
+    });
+    server.registerTool('delete-project', {
+        description: 'Delete a project and all its deployments from sota.io. This action is permanent.',
+        inputSchema: {
+            project_id: z.string().describe('Project ID to delete'),
+        },
+    }, async ({ project_id }) => {
+        try {
+            await client.deleteProject(project_id);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Project ${project_id} deleted successfully.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Delete failed: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,MAAqB;IAC3E,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE;QACnC,WAAW,EAAE,2CAA2C;KACzD,EAAE,KAAK,IAAI,EAAE;QACZ,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,EAAE,CAC7C,CAAC;QACF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;wBACzB,CAAC,CAAC,sDAAsD;wBACxD,CAAC,CAAC,cAAc,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACrC;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE;QACpC,WAAW,EAAE,iCAAiC;QAC9C,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;SACtD;KACF,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACpB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,6BAA6B,OAAO,CAAC,IAAI,aAAa,OAAO,CAAC,IAAI,WAAW,OAAO,CAAC,EAAE,oBAAoB,OAAO,CAAC,IAAI,UAAU;iBACxI;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE;QACpC,WAAW,EAAE,kFAAkF;QAC/F,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;SACxD;KACF,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACvC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,WAAW,UAAU,wBAAwB;qBACpD;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,kBAAkB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACjF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/rollback.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SotaAPIClient } from '../api-client.js';
+export declare function registerRollbackTool(server: McpServer, client: SotaAPIClient): void;
+//# sourceMappingURL=rollback.d.ts.map

package/dist/tools/rollback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.d.ts","sourceRoot":"","sources":["../../src/tools/rollback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,QA6B5E"}

package/dist/tools/rollback.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+export function registerRollbackTool(server, client) {
+    server.registerTool('rollback', {
+        description: 'Rollback a project to its previous deployment. This swaps the container image without rebuilding.',
+        inputSchema: {
+            project_id: z.string().describe('Project ID to rollback'),
+        },
+    }, async ({ project_id }) => {
+        try {
+            const deployment = await client.rollback(project_id);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Rollback successful:\n  Deployment ID: ${deployment.id}\n  Status: ${deployment.status}\n  URL: ${deployment.url || 'pending'}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Rollback failed: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=rollback.js.map

package/dist/tools/rollback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.js","sourceRoot":"","sources":["../../src/tools/rollback.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,MAAqB;IAC3E,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE;QAC9B,WAAW,EAAE,mGAAmG;QAChH,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SAC1D;KACF,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YACrD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,0CAA0C,UAAU,CAAC,EAAE,eAAe,UAAU,CAAC,MAAM,YAAY,UAAU,CAAC,GAAG,IAAI,SAAS,EAAE;qBACvI;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,oBAAoB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACnF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/status.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SotaAPIClient } from '../api-client.js';
+export declare function registerStatusTool(server: McpServer, client: SotaAPIClient): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,QAgE1E"}

package/dist/tools/status.js

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+export function registerStatusTool(server, client) {
+    server.registerTool('get-status', {
+        description: 'Get the current deployment status for a project, including URL and recent deployment history',
+        inputSchema: {
+            project_id: z.string().describe('Project ID to check status for'),
+        },
+    }, async ({ project_id }) => {
+        try {
+            const deployments = await client.getDeployments(project_id);
+            if (deployments.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'No deployments found. Use the deploy tool to deploy your app.',
+                        },
+                    ],
+                };
+            }
+            const latest = deployments[0];
+            const lines = [
+                `Current deployment:`,
+                `  ID: ${latest.id}`,
+                `  Status: ${latest.status}`,
+                `  URL: ${latest.url || 'not available'}`,
+                `  Created: ${latest.created_at}`,
+            ];
+            if (latest.framework) {
+                lines.push(`  Framework: ${latest.framework}`);
+            }
+            if (latest.error) {
+                lines.push(`  Error: ${latest.error}`);
+            }
+            if (deployments.length > 1) {
+                lines.push('', 'Recent deployments:');
+                for (const d of deployments.slice(1, 5)) {
+                    lines.push(`  ${d.id.slice(0, 8)} - ${d.status} (${d.created_at})`);
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: lines.join('\n'),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to get status: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAqB;IACzE,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE;QAChC,WAAW,EAAE,8FAA8F;QAC3G,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;SAClE;KACF,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YAE5D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,+DAA+D;yBACtE;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG;gBACZ,qBAAqB;gBACrB,SAAS,MAAM,CAAC,EAAE,EAAE;gBACpB,aAAa,MAAM,CAAC,MAAM,EAAE;gBAC5B,UAAU,MAAM,CAAC,GAAG,IAAI,eAAe,EAAE;gBACzC,cAAc,MAAM,CAAC,UAAU,EAAE;aAClC,CAAC;YAEF,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACzC,CAAC;YAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,qBAAqB,CAAC,CAAC;gBACtC,KAAK,MAAM,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBACxC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;qBACvB;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACxF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@sota-io/mcp",
+  "version": "1.0.0",
+  "mcpName": "io.github.sota-io/sota",
+  "description": "MCP server for sota.io - deploy web apps via AI agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "sota-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sota-io/mcp"
+  },
+  "homepage": "https://sota.io/docs/mcp",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "sota",
+    "deploy",
+    "paas",
+    "ai-agent",
+    "claude",
+    "devops"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "tsx": "^4.0.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "license": "MIT"
+}