MCP Server

The Portabase MCP server exposes your dashboard over the Model Context Protocol, allowing AI assistants (Claude, Cursor, Windsurf, etc.) to manage databases, agents, and backups through natural language.

Prerequisites

• Portabase dashboard running with both API_ENABLED=true and MCP_ENABLED=true
• An API token (see API Introduction)
• Node.js 18+ on the machine running your AI assistant

Enable MCP

Set both environment variables before starting your dashboard:

API_ENABLED=true
MCP_ENABLED=true

• API_ENABLED=true: enables all API routes under /api/v1
• MCP_ENABLED=true: enables the MCP server at /api/v1/mcp

Connection

Add the following to your AI assistant's MCP configuration, replacing the URL and API key with your own:

{
  "mcpServers": {
    "portabase": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-dashboard.example.com/api/v1/mcp",
        "--header",
        "x-api-key: YOUR_API_TOKEN"
      ]
    }
  }
}

{
  "portabase": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://your-dashboard.example.com/api/v1/mcp",
      "--header",
      "x-api-key: YOUR_API_TOKEN"
    ]
  }
}

{
  "mcpServers": {
    "portabase": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-dashboard.example.com/api/v1/mcp",
        "--header",
        "x-api-key: YOUR_API_TOKEN"
      ]
    }
  }
}

Verify the connection

Restart your AI assistant. Ask it:

"List my Portabase databases"

A successful response confirms the MCP server is connected.

Available Tools

See the Tools reference for the full list of operations.