npm package: @promptline/mcp-server
Description: PromptLine MCP Server — Manage prompts, execute AI, orchestrate agents, and run evaluations from any MCP client.
Author: PromptLine
Latest version: 1.0.9

# @promptline/mcp-server

PromptLine MCP Server — Manage prompts, execute AI, orchestrate agents, and run evaluations from Claude Code, Claude Desktop, Cursor, VS Code, or any MCP client.

## Installation

### Claude Code

One command:

```bash
claude mcp add promptline \
  -e PROMPTLINE_API_KEY=sk_your_api_key \
  -- npx @promptline/mcp-server
```

Restart Claude Code. Verify with `claude mcp list`.

### Claude Desktop

Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "promptline": {
      "url": "https://api.promptlineops.ai/mcp/platform",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer sk_your_api_key"
      }
    }
  }
}
```

Restart Claude Desktop.

### Cursor

Create or edit `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "promptline": {
      "command": "npx",
      "args": ["@promptline/mcp-server"],
      "env": {
        "PROMPTLINE_API_KEY": "sk_your_api_key"
      }
    }
  }
}
```

Restart Cursor. Requires Node.js 18+.

### VS Code (Copilot)

Open Settings (Cmd+,) > search "MCP" > Edit in settings.json:

```json
{
  "mcp": {
    "servers": {
      "promptline": {
        "url": "https://api.promptlineops.ai/mcp/platform",
        "type": "streamable-http",
        "headers": {
          "Authorization": "Bearer sk_your_api_key"
        }
      }
    }
  }
}
```

### Windsurf

Create or edit `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "promptline": {
      "command": "npx",
      "args": ["@promptline/mcp-server"],
      "env": {
        "PROMPTLINE_API_KEY": "sk_your_api_key"
      }
    }
  }
}
```

### Any MCP Client (generic)

**Option A — Remote (Streamable HTTP):**

```json
{
  "url": "https://api.promptlineops.ai/mcp/platform",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer sk_your_api_key"
  }
}
```

**Option B — stdio proxy (npm):**

```bash
PROMPTLINE_API_KEY=sk_your_api_key npx @promptline/mcp-server
```

## Available Tools (47)

| Category | Tools |
|----------|-------|
| **Skills** | `list_skills`, `get_skill`, `get_skill_by_name`, `create_skill`, `delete_skill`, `update_skill`, `run_skill`, `list_skill_versions`, `list_providers` |
| **Workspaces** | `list_workspaces` |
| **Agents** | `list_agents`, `get_agent`, `run_agent`, `get_execution`, `get_execution_stats` |
| **Workflows** | `execute_workflow`, `resume_workflow`, `list_agent_skills` |
| **Evaluation** | `run_evaluation`, `get_eval_results`, `list_evaluations` |
| **RAG** | `query_knowledge_base`, `list_knowledge_bases`, `list_datasets` |
| **Governance** | `check_governance`, `get_analytics` |
| **Apps** | `dashboard_app`, `eval_report_app`, `prompt_diff_app`, `workflow_viz_app`, `form_app` |
| **Operations** | `ab_test`, `monitor_stream`, `audit_trail`, `cost_forecast`, `rollback` |
| **Datasets** | `create_dataset`, `list_datasets`, `get_dataset`, `add_dataset_rows`, `search_datasets`, `compare_dataset_versions`, `suggest_dataset_mapping`, `attach_dataset` |
| **Deployment** | `deploy_skill`, `list_deployments`, `promote_deployment` |

All tools are prefixed with `promptline_` (e.g. `promptline_list_skills`).

## Environment Variables

| Variable | Required | Default |
|----------|----------|---------|
| `PROMPTLINE_API_KEY` | Yes | — |
| `PROMPTLINE_URL` | No | `https://api.promptlineops.ai` |

## Get your API key

1. Go to [app.promptlineops.ai](https://app.promptlineops.ai)
2. Settings > API Keys > Create Key
3. Copy the `sk_org_...` key

## License

MIT