MCP Server | Agile Data Engine

Private Preview

The ADE MCP Server exposes ADE metadata and product documentation to AI coding assistants via the Model Context Protocol (MCP).

Connecting

Authentication uses External API keys, which can be created from Admin UI.

During Private Preview, network access is IP-restricted. Contact ADE support to request MCP Server activation.

VSCode with GitHub Copilot

The following example shows a config with design, dev and prod environments. Place it in .vscode/mcp.json in your project:

mcp.json

JSON

{
  "servers": {
    "ade-mcp-design": {
      "url": "https://external.services.saas.agiledataengine.com/mcp/<tenant>/<installation>/design",
      "type": "http",
      "headers": {
        "X-API-KEY-ID": "${input:ade-design-key-id}",
        "X-API-KEY-SECRET": "${input:ade-design-key-secret}"
      }
    },
    "ade-mcp-dev": {
      "url": "https://external.services.saas.agiledataengine.com/mcp/<tenant>/<installation>/dev",
      "type": "http",
      "headers": {
        "X-API-KEY-ID": "${input:ade-dev-key-id}",
        "X-API-KEY-SECRET": "${input:ade-dev-key-secret}"
      }
    },
    "ade-mcp-prod": {
      "url": "https://external.services.saas.agiledataengine.com/mcp/<tenant>/<installation>/prod",
      "type": "http",
      "headers": {
        "X-API-KEY-ID": "${input:ade-prod-key-id}",
        "X-API-KEY-SECRET": "${input:ade-prod-key-secret}"
      }
    }
  },
  "inputs": [
    {
      "id": "ade-design-key-id",
      "type": "promptString",
      "description": "DESIGN: ADE API Key ID"
    },
    {
      "id": "ade-design-key-secret",
      "type": "promptString",
      "description": "DESIGN: ADE API Key Secret",
      "password": true
    },
    {
      "id": "ade-dev-key-id",
      "type": "promptString",
      "description": "DEV: ADE API Key ID"
    },
    {
      "id": "ade-dev-key-secret",
      "type": "promptString",
      "description": "DEV: ADE API Key Secret",
      "password": true
    },
    {
      "id": "ade-prod-key-id",
      "type": "promptString",
      "description": "PROD: ADE API Key ID"
    },
    {
      "id": "ade-prod-key-secret",
      "type": "promptString",
      "description": "PROD: ADE API Key Secret",
      "password": true
    }
  ]
}

Be sure to replace tenant and installation in the above configuration.

In VSCode, you need to input in a prompt the API key ID and Secret.

Claude Code

Add the following to .mcp.json in your project:

.mcp.json

JSON

{
  "mcpServers": {
    "ade-mcp-design": {
      "type": "http",
      "url": "https://external.services.saas.agiledataengine.com/mcp/<tenant>/<installation>/design",
      "headers": {
        "X-API-KEY-ID": "${ADE_DESIGN_API_KEY_ID}",
        "X-API-KEY-SECRET": "${ADE_DESIGN_API_KEY_SECRET}"
      }
    },
    "ade-mcp-dev": {
      "type": "http",
      "url": "https://external.services.saas.agiledataengine.com/mcp/<tenant>/<installation>/dev",
      "headers": {
        "X-API-KEY-ID": "${ADE_DEV_API_KEY_ID}",
        "X-API-KEY-SECRET": "${ADE_DEV_API_KEY_SECRET}"
      }
    },
    "ade-mcp-prod": {
      "type": "http",
      "url": "https://external.services.saas.agiledataengine.com/mcp/<tenant>/<installation>/prod",
      "headers": {
        "X-API-KEY-ID": "${ADE_PROD_API_KEY_ID}",
        "X-API-KEY-SECRET": "${ADE_PROD_API_KEY_SECRET}"
      }
    }
  }
}

Be sure to replace tenant and installation in the above configuration.

In Claude Code you need to setup the environment variables for API-keys.

Tools

The MCP server exposes:

All GET endpoints from the External API
ADE product documentation

The set of available tools depends on the environment type. Design environments expose design-time tools, runtime environments expose runtime tools. The server only lists tools relevant to the connected environment.

Tool outputs

By default, tool outputs use TOON format for a more compact representation.

To get plain JSON instead, add the following header to your MCP connection config:

"X-OUTPUT-ONLY-JSON": "true"