deploy-mcp 0.3.0 → 0.5.0

package/README.md

@@ -16,6 +16,7 @@ No more context-switching. No more dashboard hunting.
 ---
 
 ## Demo
+─────────────────────────
 
 ### Your conversation:
 ```
@@ -44,49 +45,8 @@ User: "Check my latest Vercel deployment"
 **Just ask your AI**: *"What's the status of my latest deployment?"*  
 Get instant answers without leaving your conversation.
 
-## Features
-
-<table>
-<tr>
-<td width="50%">
-
-**Universal AI Support**  
-Built for the Model Context Protocol. Works seamlessly with Claude Desktop, VS Code, Cursor, Windsurf, Continue.dev, Cline, and any MCP-compatible AI assistant.
-
-**Secure & Private**  
-Your API tokens stay local on your machine. Never sent to third parties or logged anywhere.
-
-**Lightning Fast**  
-Get deployment status in under 2 seconds. Optimized for developer productivity.
-
-</td>
-<td width="50%">
-
-**Zero Context Switching**  
-Check deployment status without leaving your AI conversation.
-
-**Universal Platform Support**  
-Currently supports Vercel, with Netlify, Railway, and Render coming soon.
-
-**Real-time Status**  
-Get instant deployment status through AI conversation.
-
-**Open Source**  
-Fully transparent, community-driven development.
-
-</td>
-</tr>
-</table>
-
-## Why deploy-mcp?
-
-**The Problem**: Developers context-switch 10-20 times per day to check deployment status, losing 23 minutes of focus each time.
-
-**The Solution**: deploy-mcp brings deployment status directly into your AI conversation. No more alt-tabbing, no more dashboard hunting, no more broken flow state.
-
-Built for the modern developer who uses AI assistants as part of their daily workflow.
-
 ## Quick Start
+─────────────────────────
 
 **Get started in under 30 seconds:**
 
@@ -96,94 +56,121 @@ npx deploy-mcp
 
 That's it! The server is now running and ready to be configured in your AI assistant.
 
-## Configuration
-
-### AI Assistants
+## Supported Platforms
+─────────────────────────
 
-<details>
-<summary><strong>Claude Desktop</strong> ✅</summary>
+deploy-mcp supports multiple deployment platforms simultaneously. Configure as many as you need:
 
-**Official MCP support** - Ready to use today
+| Platform | Status | Token Required | Features |
+|----------|--------|---------------|----------|
+| **Vercel** | ✅ Ready | `VERCEL_TOKEN` | Status, Logs, History, Real-time Monitoring |
+| **Netlify** | ✅ Ready | `NETLIFY_TOKEN` | Status, Logs, History, Real-time Monitoring |
+| **Railway** | Coming Soon | `RAILWAY_TOKEN` | - |
+| **Render** | Coming Soon | `RENDER_TOKEN` | - |
 
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
-**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`  
-**Linux**: `~/.config/Claude/claude_desktop_config.json`
+### Multi-Platform Configuration
 
-</details>
+You can use **multiple platforms simultaneously** by providing tokens for each platform you want to track:
 
-<details>
-<summary><strong>VS Code</strong> ✅</summary>
-
-**Official MCP support** - Generally available in VS Code 1.102+
+```json
+{
+  "mcpServers": {
+    "deploy-mcp": {
+      "command": "npx",
+      "args": ["-y", "deploy-mcp"],
+      "env": {
+        "VERCEL_TOKEN": "your-vercel-token",
+        "NETLIFY_TOKEN": "your-netlify-token"
+        // Add more platform tokens as needed
+      }
+    }
+  }
+}
+```
 
-Add to workspace `.vscode/mcp.json` or global `~/.vscode/mcp.json`
+## Platform Configuration
+─────────────────────────
 
-Requires GitHub Copilot subscription and MCP policy enabled by organization.
-</details>
+### Vercel
 
 <details>
-<summary><strong>Cursor AI</strong> ✅</summary>
+<summary><strong>Setup Instructions</strong></summary>
+
+1. **Get your API token:**
+   - Go to [vercel.com/account/tokens](https://vercel.com/account/tokens)
+   - Click "Create Token"
+   - Give it a descriptive name (e.g., "deploy-mcp")
+   - Copy the token
+
+2. **Add to your AI assistant configuration:**
+   ```json
+   {
+     "env": {
+       "VERCEL_TOKEN": "your-vercel-token"
+     }
+   }
+   ```
 
-**Official MCP support** - Available with one-click installation
+3. **Available commands:**
+   - `"Check my Vercel deployment for project-name"`
+   - `"What's the status of my latest Vercel deployment?"`
+   - `"Show me Vercel deployment logs"`
+   - `"Watch my Vercel deployment progress"`
+   - `"List all my Vercel projects"`
+   - `"Show last 5 deployments for project-name"`
 
-Navigate to Cursor Settings → MCP or create `~/.cursor/mcp.json`
+4. **Required permissions:** Read access to deployments and projects
 
 </details>
 
-<details>
-<summary><strong>Windsurf IDE</strong> ✅</summary>
-
-**Official MCP support** - Native integration with Cascade
-
-Navigate to Windsurf Settings → Advanced Settings → Cascade or edit `~/.codeium/windsurf/mcp_config.json`
-
-</details>
+### Netlify
 
 <details>
-<summary><strong>Continue.dev</strong> ✅</summary>
+<summary><strong>Setup Instructions</strong></summary>
+
+1. **Get your API token:**
+   - Go to [app.netlify.com/user/applications](https://app.netlify.com/user/applications)
+   - Under "Personal access tokens", click "New access token"
+   - Give it a descriptive name (e.g., "deploy-mcp")
+   - Copy the token
+
+2. **Add to your AI assistant configuration:**
+   ```json
+   {
+     "env": {
+       "NETLIFY_TOKEN": "your-netlify-token"
+     }
+   }
+   ```
 
-**Official MCP support** - Available in agent mode
+3. **Available commands:**
+   - `"Check my Netlify deployment for site-name"`
+   - `"What's the status of my latest Netlify deployment?"`
+   - `"Show me Netlify deployment logs"`
+   - `"Watch my Netlify deployment progress"`
+   - `"List all my Netlify sites"`
+   - `"Show deployment history for site-name"`
 
-Add to your `config.json` with different structure:
+4. **Required permissions:** Read access to sites and deploys
 
-```json
-{
-  "experimental": {
-    "modelContextProtocolServer": {
-      "transport": {
-        "type": "stdio",
-        "command": "npx",
-        "args": ["-y", "deploy-mcp"]
-      },
-      "env": {
-        "VERCEL_TOKEN": "your-vercel-token"
-      }
-    }
-  }
-}
-```
-
-Or create `.continue/mcpServers/` folder in your workspace.
 </details>
 
-<details>
-<summary><strong>Cline (VS Code)</strong> ✅</summary>
-
-**Official MCP support** - Can create and install tools automatically
-
-Cline can install deploy-mcp through natural language:
-- Ask: *"Add the deploy-mcp tool to check Vercel deployments"*
-- Or manually configure via MCP Servers icon → Advanced MCP Settings
+## AI Assistant Configuration
+─────────────────────────
 
-</details>
+deploy-mcp works with any MCP-compatible AI assistant. Here's how to set it up:
 
-**+ Any MCP-compatible tool**  
-Works with all AI assistants that support [Model Context Protocol](https://modelcontextprotocol.io)
+### Claude Desktop
 
-### MCP Configuration
+<details>
+<summary><strong>Configuration</strong></summary>
 
-All AI tools (except Continue.dev) use the same configuration:
+**File location:**
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`  
+- **Linux**: `~/.config/Claude/claude_desktop_config.json`
 
+**Configuration:**
 ```json
 {
   "mcpServers": {
@@ -191,592 +178,270 @@ All AI tools (except Continue.dev) use the same configuration:
       "command": "npx",
       "args": ["-y", "deploy-mcp"],
       "env": {
-        "VERCEL_TOKEN": "your-vercel-token"
+        "VERCEL_TOKEN": "your-vercel-token",
+        "NETLIFY_TOKEN": "your-netlify-token"
       }
     }
   }
 }
 ```
 
-💡 Replace `your-vercel-token` with your actual Vercel API token from [vercel.com/account/tokens](https://vercel.com/account/tokens)
-
-## Deployment Status Badges
-
-Get live deployment status badges for your repositories that update in real-time via webhooks.
-
-### Badge URLs
-
-Add these badges to your README to show live deployment status:
-
-```markdown
-![Vercel Deployment](https://deploy-mcp.io/badge/username/repository/vercel)
-```
-
-**Examples:**
-- `https://deploy-mcp.io/badge/john/my-app/vercel`
-- `https://deploy-mcp.io/badge/youruser/yourrepo/vercel`
-
-**⚠️ Requirements:**
-- **Public repositories only** - Private repos not supported for security reasons
-- **Vercel Pro/Enterprise plan** - Webhooks required for real-time badge updates
-
-**For free tier users:** The MCP server works perfectly for checking deployment status in your AI conversations. Badges are a premium feature requiring paid Vercel plans.
-
-### Setting Up Webhooks
-
-For badges to show real-time status, configure webhooks in your deployment platform:
-
-#### Vercel Setup
-
-**Note:** Vercel webhooks require a Pro or Enterprise plan.
-
-1. **Go to your Vercel team settings**
-2. **Navigate to "Webhooks" section**
-3. **Click "Create Webhook"**
-4. **Configure the webhook:**
-   - **URL**: `https://deploy-mcp.io/webhook/yourusername/yourrepo/vercel`
-   - **Events**: Select "Deployment Created", "Deployment Ready", and "Deployment Error"
-   - **Projects**: Choose your specific project or leave empty for all projects
-   - **Secret**: Leave empty (not required for public repositories)
-5. **Save the webhook**
-
-**Important:** Replace `yourusername` and `yourrepo` with your actual GitHub username and repository name.
-
-**Note:** Vercel's free tier doesn't support webhooks, so badges won't work. Use the MCP server instead for deployment status in your AI conversations.
-
-#### Supported Events
-
-The webhook will trigger on:
-- ✅ Deployment started (badge shows "building")
-- ✅ Deployment succeeded (badge shows "success")
-- ❌ Deployment failed (badge shows "failed")
-- ⚠️ Deployment errored (badge shows "error")
-
-#### Badge Status Colors
-
-- 🟢 **Success** - Green badge when deployment is live
-- 🔴 **Failed** - Red badge when deployment failed
-- 🟡 **Building** - Yellow badge during deployment
-- ⚫ **Unknown** - Grey badge when no status available
-- 🔴 **Error** - Red badge when deployment errored
-
-### Testing Your Setup
-
-1. **Add the badge** to your repository README
-2. **Configure the webhook** as described above
-3. **Make a commit** and push to trigger a deployment
-4. **Watch the badge** update in real-time during deployment
-
-**Initial badge status will show "unknown" until the first webhook is received.**
-
+</details>
 
-### Getting API Tokens
+### VS Code
 
 <details>
-<summary><strong>Vercel</strong></summary>
+<summary><strong>Configuration</strong></summary>
 
-1. Go to [Vercel Dashboard](https://vercel.com/account/tokens)
-2. Click **"Create Token"**
-3. Give it a descriptive name (e.g., "deploy-mcp")
-4. Select appropriate scope (read-only is sufficient)
-5. Copy the token and add it to your configuration
+**File location:**
+- Workspace: `.vscode/mcp.json`
+- Global: `~/.vscode/mcp.json`
 
-</details>
+**Requirements:** GitHub Copilot subscription with MCP enabled
 
-<details>
-<summary><strong>Netlify</strong> (Coming Soon)</summary>
+**Configuration:** Same as Claude Desktop
 
-1. Go to [Netlify User Settings](https://app.netlify.com/user/applications#personal-access-tokens)
-2. Click **"New access token"**
-3. Give it a descriptive name
-4. Copy the token
 </details>
 
-<details>
-<summary><strong>Railway</strong> (Coming Soon)</summary>
-
-Railway integration is on our roadmap. [Star the repo](https://github.com/alexpota/deploy-mcp) to get notified!
-</details>
+### Cursor AI
 
 <details>
-<summary><strong>Render</strong> (Coming Soon)</summary>
+<summary><strong>Configuration</strong></summary>
 
-Render integration is on our roadmap. [Star the repo](https://github.com/alexpota/deploy-mcp) to get notified!
-</details>
+**File location:** `~/.cursor/mcp.json`
 
-## Usage Examples
+**Setup:** Navigate to Cursor Settings → MCP
 
-### Quick Examples by Tool
+**Configuration:** Same as Claude Desktop
 
-#### 1. Check Deployment Status
+</details>
 
-> 💬 **Ask your AI:**
-> - "Check my Vercel deployment"
-> - "Is my website live?"
-> - "Show deployment status for my-app"
+### Windsurf IDE
 
-#### 2. Watch Deployment (Real-time)
+<details>
+<summary><strong>Configuration</strong></summary>
 
-> 💬 **Ask your AI:**
-> - "Watch my deployment"
-> - "Stream my build progress"
-> - "Show me real-time deployment updates"
+**File location:** `~/.codeium/windsurf/mcp_config.json`
 
-Get live updates as your deployment progresses through initialization, building, and completion.
+**Setup:** Settings → Advanced Settings → Cascade
 
-#### 3. Compare Deployments
+**Configuration:** Same as Claude Desktop
 
-> 💬 **Ask your AI:**
-> - "Compare my last 2 deployments"
-> - "What changed in my latest deployment?"
-> - "Show build time differences"
+</details>
 
-See performance metrics, risk assessment, and identify what changed between deployments.
+### Continue.dev
 
-#### 4. Get Deployment Logs
+<details>
+<summary><strong>Configuration</strong></summary>
 
-> 💬 **Ask your AI:**
-> - "Show deployment logs"
-> - "Why did my deployment fail?"
-> - "Get error logs for deployment dpl_ABC123"
+**File location:** `~/.continue/config.json`
 
-Get intelligent error analysis with suggested fixes and filtered log output.
+**Configuration (different structure):**
+```json
+{
+  "experimental": {
+    "modelContextProtocolServer": {
+      "transport": {
+        "type": "stdio",
+        "command": "npx",
+        "args": ["-y", "deploy-mcp"]
+      },
+      "env": {
+        "VERCEL_TOKEN": "your-vercel-token",
+        "NETLIFY_TOKEN": "your-netlify-token"
+      }
+    }
+  }
+}
+```
 
-### MCP Server Usage
+</details>
 
-Once configured with your AI assistant, simply ask:
+### Cline (VS Code Extension)
 
-#### Example: Check Status
+<details>
+<summary><strong>Configuration</strong></summary>
 
-**You:** "Check my latest Vercel deployment"
+**Natural language setup:**
+- Ask: *"Add the deploy-mcp tool to check deployments"*
 
-**Assistant:**
-> I'll check your latest Vercel deployment for you.
->
-> ## Deployment Status
-> 
-> ### Current Status
-> **Project:** my-app  
-> **Platform:** Vercel  
-> **Status:** ✅ Success  
-> **URL:** https://my-app.vercel.app  
-> **Duration:** 45s  
-> **Deployed:** 2 hours ago  
-> 
-> ### Commit Info
-> **SHA:** `abc123ef`  
-> **Message:** Update homepage hero section  
-> **Author:** John Doe  
-> 
-> Everything looks good - your deployment is live and running successfully!
+**Manual setup:**
+- MCP Servers icon → Advanced MCP Settings
 
-#### Example: Real-time Monitoring
+**Configuration:** Same as Claude Desktop
 
-**You:** "Watch my deployment"
+</details>
 
-**Assistant:**
-> ## Deployment Watch
-> 
-> ### Real-time Updates
-> 🔄 **Starting to watch deployment for my-app**
-> 
-> 🔄 **Deployment state: INITIALIZING**
-> 
-> 🔄 **Deployment state: BUILDING**  
->    Duration: 15s
-> 
-> ✅ **Deployment successful!**  
->    URL: https://my-app.vercel.app  
->    Duration: 45s
+## Deployment Status Badges
+─────────────────────────
 
-**More examples:**
-- `"Is my website deployment finished?"`
-- `"Show me the deployment status for project-xyz"`
-- `"Check if the production deployment succeeded"`
-- `"What's the status of my latest deploy?"`
-- `"Watch my deployment in real-time"` **[NEW]**
-- `"Compare my last 2 deployments"` **[NEW]**
-- `"Show me the deployment logs for the failed build"` **[NEW]**
-- `"What changed between my current and previous deployment?"` **[NEW]**
+Get live deployment status badges for your repositories:
 
-### Badge Usage
+### Badge Format
 
-Add live deployment status badges to your README:
+The deploy-mcp.io endpoint returns JSON data for shields.io. Use the shields.io endpoint wrapper:
 
 ```markdown
-# My Project
+![Platform Deployment](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/{username}/{repository}/{platform})
+```
 
-![Vercel](https://deploy-mcp.io/badge/yourusername/yourrepo/vercel)
+### Examples by Platform
 
-<!-- Other content -->
+#### Vercel Badge
+```markdown
+![Vercel](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/john/my-app/vercel)
 ```
 
-**Multiple platforms:**
+#### Netlify Badge
 ```markdown
-[![Vercel](https://deploy-mcp.io/badge/user/repo/vercel)](https://deploy-mcp.io)
-[![Netlify](https://deploy-mcp.io/badge/user/repo/netlify)](https://deploy-mcp.io)
+![Netlify](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/john/my-app/netlify)
 ```
 
+#### Multiple Badges
+```markdown
+![Vercel](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/john/my-app/vercel)
+![Netlify](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/john/my-app/netlify)
+```
 
-## MCP Tools Reference
-
-The MCP server provides four powerful tools for comprehensive deployment tracking:
+### Webhook Configuration
 
-### 1. check_deployment_status
-Retrieve the latest deployment status for a project.
+For real-time badge updates, configure webhooks:
 
 <details>
-<summary><strong>Parameters</strong></summary>
+<summary><strong>Vercel Webhooks</strong> (Pro/Enterprise only)</summary>
 
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `platform` | string | ✓ | Deployment platform (`vercel`, `netlify`, etc.) |
-| `project` | string | ✓ | Project name or ID |
-| `token` | string | ✗ | API token (uses env variable if not provided) |
+1. Go to your Vercel team settings
+2. Navigate to "Webhooks" section
+3. Click "Create Webhook"
+4. Configure:
+   - **URL**: `https://deploy-mcp.io/webhook/{username}/{repo}/vercel`
+   - **Events**: Deployment Created, Ready, Error
+   - **Projects**: Select specific or all
 
 </details>
 
-### 2. watch_deployment **[NEW]**
-Stream real-time deployment progress with live updates.
-
 <details>
-<summary><strong>Parameters</strong></summary>
+<summary><strong>Netlify Webhooks</strong></summary>
 
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `platform` | string | ✓ | Deployment platform (`vercel`, `netlify`, etc.) |
-| `project` | string | ✓ | Project name or ID |
-| `deploymentId` | string | ✗ | Specific deployment ID (latest if not specified) |
-| `token` | string | ✗ | API token (uses env variable if not provided) |
+1. Go to Site Settings → Build & deploy → Deploy notifications
+2. Add notification → Outgoing webhook
+3. Configure:
+   - **URL**: `https://deploy-mcp.io/webhook/{username}/{repo}/netlify`
+   - **Events**: Deploy started, succeeded, failed
 
 </details>
 
-### 3. compare_deployments **[NEW]**
-Compare current deployment with previous versions to identify changes and performance differences.
+**Note:** Badges require public repositories. Private repo support coming soon.
 
-<details>
-<summary><strong>Parameters</strong></summary>
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `platform` | string | ✓ | Deployment platform (`vercel`, `netlify`, etc.) |
-| `project` | string | ✓ | Project name or ID |
-| `count` | number | ✗ | Number of deployments to compare (default: 2) |
-| `token` | string | ✗ | API token (uses env variable if not provided) |
+## Available Tools
+─────────────────────────
 
-</details>
+deploy-mcp provides these tools to your AI assistant:
 
-### 4. get_deployment_logs **[NEW]**
-Fetch and analyze deployment logs with intelligent error detection.
+### Core Tools
 
-<details>
-<summary><strong>Parameters</strong></summary>
+| Tool | Description | Example Command |
+|------|-------------|-----------------|
+| `check_deployment_status` | Get latest deployment status or history | *"Check my deployment status"* / *"Show last 5 deployments"* |
+| `watch_deployment` | Monitor deployment in real-time | *"Watch my deployment progress"* |
+| `compare_deployments` | Compare recent deployments | *"Compare my last 2 deployments"* |
+| `get_deployment_logs` | Fetch deployment logs | *"Show me deployment logs"* |
+| `list_projects` | List all available projects | *"List my Vercel projects"* / *"Show all Netlify sites"* |
 
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `platform` | string | ✓ | Deployment platform (`vercel`, `netlify`, etc.) |
-| `deploymentId` | string | ✓ | Deployment ID to fetch logs for |
-| `filter` | string | ✗ | Filter logs: `error`, `warning`, or `all` (default: `error`) |
-| `token` | string | ✗ | API token (uses env variable if not provided) |
+### Platform-Specific Usage
 
-</details>
-
-<details>
-<summary><strong>Response Formats</strong></summary>
+Commands work across all configured platforms:
 
-All tools return clean, Markdown-formatted responses for consistent display across AI tools:
-
-```markdown
-## Deployment Status
-
-### Current Status
-**Project:** my-app  
-**Platform:** Vercel  
-**Status:** ✅ Success  
-**URL:** https://my-app.vercel.app  
-**Duration:** 45s  
-**Deployed:** 2 hours ago  
-
-### Commit Info
-**SHA:** `abc1234`  
-**Message:** Fix navigation bug  
-**Author:** John Doe  
 ```
-
-</details>
-
-## Development
-
-For contributors who want to help develop deploy-mcp.
-
-### Prerequisites
-
-- Node.js 22 or higher
-- npm, yarn, or pnpm
-
-### Local Development
-
-```bash
-# Clone the repository
-git clone https://github.com/alexpota/deploy-mcp.git
-cd deploy-mcp
-
-# Install dependencies
-npm install
-
-# Run in development mode  
-npm run dev
+"Check my Vercel deployment for my-app"
+"Show last 10 deployments for my-app on Vercel"
+"List all my Vercel projects"
+"Check my Netlify deployment for my-site"
+"Show me logs for deployment abc123 on Vercel"
+"Watch my Netlify deployment progress"
+"Show all my Netlify sites"
 ```
 
-### Testing
+### New Features
 
-```bash
-# Run tests
-npm test
-
-# Type checking
-npm run lint
+#### List Projects
+Discover all your projects/sites across platforms:
 ```
-
-### Building & Deployment
-
-```bash
-# Build TypeScript
-npm run build
-
-# Deploy worker to Cloudflare
-npm run deploy
-
-# Development worker server
-npm run dev:worker
+"List my Vercel projects"
+"Show all Netlify sites"
+"What projects do I have on Vercel?"
 ```
 
-## Project Structure
-
+#### Deployment History
+View multiple recent deployments at once:
 ```
-deploy-mcp/
-├── src/
-│   ├── index.ts                      # MCP server entry point
-│   ├── worker.ts                     # Cloudflare Worker for website
-│   ├── adapters/                     # Platform adapters
-│   │   ├── base/                     # Base adapter framework
-│   │   │   ├── adapter.ts            # Abstract base class
-│   │   │   ├── api-client.ts         # HTTP client with rate limiting
-│   │   │   └── index.ts              # Base exports
-│   │   ├── vercel/                   # Vercel platform support
-│   │   │   ├── index.ts              # Main adapter class
-│   │   │   ├── api.ts                # Vercel API client
-│   │   │   ├── endpoints.ts          # API endpoint configs
-│   │   │   └── __tests__/            # Vercel tests
-│   │   └── index.ts                  # All adapter exports
-│   ├── core/
-│   │   ├── mcp-handler.ts            # MCP protocol implementation
-│   │   ├── tools.ts                  # MCP tool definitions (4 tools)
-│   │   ├── deployment-intelligence.ts # Real-time streaming
-│   │   ├── response-formatter.ts     # Markdown formatting
-│   │   └── constants.ts              # Configuration constants
-│   ├── server/
-│   │   ├── badge.ts                  # SVG badge generation
-│   │   └── webhook.ts                # Webhook handler
-│   └── types.ts                      # TypeScript definitions
-├── tests/                             # Integration tests
-├── dist/                              # Compiled output
-├── wrangler.toml                      # Cloudflare config
-├── tsconfig.json                      # TypeScript config
-└── package.json                       # Project metadata
+"Show last 5 deployments for my-app"
+"Get deployment history for my-site"
+"Check last 10 deployments on Vercel"
 ```
 
-## Security
-
-### Our Security Commitments
-
-- **Local-Only Tokens** - Your API tokens never leave your machine
-- **No Data Collection** - We don't track, log, or store any user data
-- **Direct API Calls** - All platform APIs are called directly from your local MCP server
-- **Open Source** - Full transparency with auditable code
-- **Badge Service** - Coming in v0.2.0 with webhook-based live deployment badges
-
-### Best Practices
-
-1. **Use Read-Only Tokens** - When possible, create tokens with minimal permissions
-2. **Rotate Tokens Regularly** - Update your tokens periodically
-3. **Environment Variables** - Store tokens in environment variables, not in code
-4. **Git Ignore** - Never commit configuration files with tokens
-
-## Platform Support & Capabilities
-
-### Platform Status
-<table>
-  <thead>
-    <tr>
-      <th>Platform</th>
-      <th>Status</th>
-      <th>Check Status</th>
-      <th>Watch Live</th>
-      <th>Compare</th>
-      <th>Get Logs</th>
-      <th>Badges</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td><strong>Vercel</strong></td>
-      <td>✅ <strong>Available</strong></td>
-      <td>✅</td>
-      <td>✅</td>
-      <td>✅</td>
-      <td>✅</td>
-      <td>✅</td>
-    </tr>
-    <tr>
-      <td><strong>Netlify</strong></td>
-      <td>🚧 <strong>In Development</strong></td>
-      <td>🚧</td>
-      <td>🚧</td>
-      <td>🚧</td>
-      <td>🚧</td>
-      <td>🚧</td>
-    </tr>
-    <tr>
-      <td><strong>Railway</strong></td>
-      <td>📅 <strong>Planned</strong></td>
-      <td>📅</td>
-      <td>📅</td>
-      <td>📅</td>
-      <td>📅</td>
-      <td>📅</td>
-    </tr>
-    <tr>
-      <td><strong>Render</strong></td>
-      <td>📅 <strong>Planned</strong></td>
-      <td>📅</td>
-      <td>📅</td>
-      <td>📅</td>
-      <td>📅</td>
-      <td>📅</td>
-    </tr>
-  </tbody>
-</table>
-
-**Legend:** ✅ Available | 🚧 In Development | 📅 Planned
-
-Want support for another platform? [Open an issue](https://github.com/alexpota/deploy-mcp/issues/new) or submit a PR\!
-
-## Troubleshooting
-
-### Common Issues & Solutions
-
-<details>
-<summary><strong>Tool not showing up in Claude</strong></summary>
-
-1. **Restart Claude Desktop** after updating configuration
-2. **Check configuration file syntax** - Ensure valid JSON
-3. **Verify file path** - Check correct config location for your OS
-4. **Check logs** - Look for MCP errors in Claude's developer console
-
-</details>
-
-<details>
-<summary><strong>Authentication errors</strong></summary>
-
-1. **Invalid token** - Verify your API token is correct and active
-2. **Token permissions** - Ensure token has read access to deployments
-3. **Environment variable** - Check `VERCEL_TOKEN` is set correctly
-4. **Token format** - Don't include quotes around token in env variable
-
-</details>
+The AI will automatically use the correct platform based on:
+1. Explicit platform mention in your command
+2. Project/site name matching
+3. Available tokens in configuration
 
-<details>
-<summary><strong>Rate limiting</strong></summary>
+## Security
+─────────────────────────
 
-The MCP server automatically handles rate limiting:
-- **Per-token limits** - 30 requests per minute per token
-- **Automatic retry** - With exponential backoff
-- **Smart polling** - Dynamic intervals based on deployment state
+- **Local tokens only** - Your API tokens stay on your machine
+- **No telemetry** - We don't track usage or collect data
+- **Open source** - Fully auditable codebase
+- **Minimal permissions** - Only read access required
 
-If you still hit limits, consider using a different token for heavy usage.
+## Advanced Configuration
+─────────────────────────
 
-</details>
+### Environment Variables
 
-<details>
-<summary><strong>Deployment not found</strong></summary>
+You can also set tokens via environment variables:
 
-1. **Project name** - Verify exact project name (case-sensitive)
-2. **Team scope** - For team projects, may need team-scoped token
-3. **Deployment exists** - Check if deployment is visible in dashboard
-4. **Platform** - Ensure you're using correct platform parameter
-
-</details>
+```bash
+export VERCEL_TOKEN="your-vercel-token"
+export NETLIFY_TOKEN="your-netlify-token"
+npx deploy-mcp
+```
 
-<details>
-<summary><strong>Real-time features not working</strong></summary>
+### Custom Installation
 
-The new streaming features (watch, compare, logs) require:
-1. **Latest version** - Update to latest `deploy-mcp` version
-2. **API access** - Some features need Pro/Enterprise Vercel plan
-3. **Active deployment** - Watch only works during active deployments
+For production use, install globally:
 
-</details>
+```bash
+npm install -g deploy-mcp
+deploy-mcp
+```
 
 ## Contributing
+─────────────────────────
 
-We love contributions\! Whether it's a bug fix, new feature, or platform support, we'd love to have you.
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
-### Quick Start
+### Adding New Platforms
 
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
-
-### Adding Platform Support
-
-Want to add support for a new platform? Here's how:
-
-1. **Create an adapter folder** in `src/adapters/your-platform/`
-2. **Implement the interface**:
-   ```typescript
-   export class YourPlatformAdapter extends BaseAdapter {
-     async getDeploymentStatus(project: string, token: string) {
-       // Your implementation
-     }
-   }
-   ```
-3. **Add tests** in `src/adapters/your-platform/__tests__/`
-4. **Update docs** with setup instructions
-5. **Submit a PR** and we'll review it\!
-
-See our [Contributing Guide](CONTRIBUTING.md) for more details.
+1. Implement the `BaseAdapter` interface
+2. Add platform-specific API client
+3. Update configuration documentation
+4. Add tests
 
 ## License
+─────────────────────────
 
-This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
+Apache 2.0 - See [LICENSE](LICENSE) for details.
 
-## Acknowledgments
+## Links
+─────────────────────────
 
-- Built with [Model Context Protocol SDK](https://github.com/modelcontextprotocol/sdk) by Anthropic
-- Hosted on [Cloudflare Workers](https://workers.cloudflare.com) for global edge performance
-- Icons from [Feather Icons](https://feathericons.com) and [Heroicons](https://heroicons.com)
-
-## Community & Support
-
-<div align="center">
-  <a href="https://github.com/alexpota/deploy-mcp/discussions">
-    <img src="https://img.shields.io/badge/GitHub-Discussions-181717?style=for-the-badge&logo=github" alt="GitHub Discussions" />
-  </a>
-  <a href="https://github.com/alexpota/deploy-mcp/issues">
-    <img src="https://img.shields.io/badge/Report-Issues-ff6b6b?style=for-the-badge&logo=github" alt="Report Issues" />
-  </a>
-  <a href="mailto:alex.potapenko.dev@gmail.com">
-    <img src="https://img.shields.io/badge/Email-alex.potapenko.dev@gmail.com-ff6b6b?style=for-the-badge&logo=gmail" alt="Email" />
-  </a>
-</div>
+- [Website](https://deploy-mcp.io)
+- [npm Package](https://www.npmjs.com/package/deploy-mcp)
+- [GitHub Repository](https://github.com/alexpota/deploy-mcp)
+- [Report Issues](https://github.com/alexpota/deploy-mcp/issues)
 
 ---
 
 <div align="center">
-  <p>Made with ❤️ by <a href="https://github.com/alexpota">Alex Potapenko</a> and contributors</p>
-  <p><a href="https://deploy-mcp.io">deploy-mcp.io</a> • <a href="https://github.com/alexpota/deploy-mcp">GitHub</a> • <a href="https://www.npmjs.com/package/deploy-mcp">NPM</a></p>
-</div>
-
+Made with ❤️ for developers who love AI-assisted coding
+</div>