Peliqan MCP Server

What is the Peliqan MCP Server?

The Peliqan MCP (Model Context Protocol) Server lets AI assistants like Claude Code and Claude Desktop talk directly to your Peliqan account. Once connected, the AI can explore your data, debug pipelines, write and run data apps, manage query tables, and call API endpoints — all without leaving your chat. Think of it as giving Claude (or any other MCP Client) a direct line into Peliqan.

Prerequisites

• A Peliqan account
• EU: use mcp.eu.peliqan.io
• US: use mcp.us.peliqan.io
• A Peliqan API token: generate an API token in Peliqan under Admin > API keys, or create a personal API key under User Settings
• Claude Code or Claude Desktop installed (or any other MCP Client)

Setup

Setup in Claude Code (terminal)

Add the following to your ~/.claude.json file. If the file doesn't exist yet, create it.

{
  "mcpServers": {
    "peliqan": {
      "type": "http",
      "url": "https://mcp.eu.peliqan.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PELIQAN_API_TOKEN"
      }
    }
  }
}

Replace YOUR_PELIQAN_API_TOKEN with your Peliqan API token.

After saving, restart Claude Code. You should see Peliqan listed when you type /mcp in the chat.

Setup in Claude Desktop

Open Claude Desktop settings → Developer → Edit Config and add the below block under mcpServers:

For Mac:

"mcpServers": {
    "peliqan": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.eu.peliqan.io/mcp",
        "--header",
        "Authorization: Bearer YOUR_PELIQAN_API_TOKEN"
      ]
    }
  }

For Windows:

"mcpServers": {
    "peliqan": {
      "command": "C:\\\"Program Files\"\\nodejs\\npx”
      "args": [
        "mcp-remote",
        "https://mcp.eu.peliqan.io/mcp",
        "--header",
        "Authorization: Bearer YOUR_PELIQAN_API_TOKEN"
      ]
    }
  }

Replace YOUR_PELIQAN_API_TOKEN with your Peliqan API token.

Make sure npx and mcp-remote are installed on your computer.

For Mac:

• brew install node
• npx mcp-remote

For Windows (PowerShell):

• winget install OpenJS.NodeJS
• npx mcp-remote

Other MCP Clients

Any MCP-compatible AI client that supports HTTPS transport can connect using the same URL and API token. Check your client's documentation on how to add an MCP Server.

For clients that support custom headers, use the URL https://mcp.eu.peliqan.io/mcp and header Authorization: Bearer YOUR_PELIQAN_API_TOKEN.

For clients that only accept a URL (without custom header support), append your API token as a query parameter:

https://mcp.eu.peliqan.io/mcp?api_key=YOUR_PELIQAN_API_TOKEN

Replace YOUR_PELIQAN_API_TOKEN with your API token.

Verifying the connection

Once connected, try these prompts to confirm everything is working:

"List my Peliqan connections" "Show me all databases in my Peliqan account” "List my data apps"

If you see results from your Peliqan account, you're all set.

What the MCP Server can do

Debug connections & pipelines

• See all your data source connections and their sync status
• View recent pipeline run history
• Read raw error logs when a sync fails

Explore your data

• Browse all databases, schemas, and tables
• Inspect column names and types
• Preview rows of data

Manage query tables

• View run history and error logs for a failing query table
• Check upstream/downstream dependencies before making changes
• Create, update, and delete SQL query tables
• Test fixes in an isolated schema before applying to production

Build & run data apps

• Write Python scripts and run them as background jobs (shell mode)
• Create interactive Streamlit web UIs and publish them with a shareable URL
• Build HTTP API handlers and expose them as REST endpoints
• Schedule scripts to run automatically

Manage API endpoints

• Create, update, and delete HTTP endpoints backed by your Python scripts
• View recent call logs for any endpoint

Sub-account management (partner accounts only)

• List all customer sub-accounts
• Run any tool against a specific sub-account by passing sub_account_id

Resources the AI can read

These are automatically available to the AI — no extra setup needed.

Example prompts to get started

Tips

• The AI reads docs automatically — before writing any Data Apps (Python scripts), tell the AI to read peliqan://docs/data-app-pq first. This ensures it uses the correct pq functions and script structure.
• Deletions are permanent — deleting a schema, table, or data app via the MCP cannot be undone.

Getting your API token

Account-wide API token:

1. Log in to Peliqan at https://app.eu.peliqan.io
2. Go to Admin > API Token & Webhooks
3. Copy your API token

Personal API token:

1. Log in to Peliqan at https://app.eu.peliqan.io
2. Click on the user icon in the bottom left corner of Peliqan
3. Select User Settings > API token
4. Copy your API token

Need help?

Reach out to Peliqan support: support@peliqan.io. You can also ask your AI (e.g. Claude) directly. Once the Peliqan MCP Server is connected, the AI has full context on how Peliqan works.