Concordium MCP Server

by Developerayo

275 downloads Not rated yet
GitHub

About

Concordium mcp-sever for interacting with the concordium chain

Explore

- Natural language queries for chain data.
- Account details, balance, and staking info.
- Block details, transaction events, and height queries.
- CIS-2 token balance checks.
- Validator list, pool details, and passive delegation.
- Smart contract instances and deployed modules.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Concordium MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- Node.js 20+
- pnpm package manager
- Docker (optional)

Add this to your mcp-server config (Claude Desktop or Cursor):

{
  "mcpServers": {
    "concordium": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--network=host", "concordium-mcp-server"],
      "env": {
        "CCD_NETWORK": "mainnet",
        "CCD_PORT": "20000",
        "CCD_SECURE": "true"
      }
    }
  }
}

For local dev without Docker:

{
  "mcpServers": {
    "concordium": {
      "command": "node",
      "args": ["/zeus/workspace/concordium-mcp-server/dist/index.js"],
      "env": {
        "CCD_NETWORK": "mainnet",
        "CCD_PORT": "20000",
        "CCD_SECURE": "true"
      }
    }
  }
}

Local (auto-configs Claude Desktop):

./scripts/local-deploy.sh

Docker:

./scripts/docker-deploy.sh

Cloud (HTTP):

./scripts/fly-deploy.sh
./scripts/railway-deploy.sh
./scripts/render-deploy.sh

Setup Wizard:


./scripts/wizard.sh

```bash

pnpm install

- "Check if account 3kBx2h5Y2veb4hZgAJWPrr8RyQESKm5TjzF3ti1QQ4VSvj6tF is staking and show me the pool details"
- "Show me transaction events in recent blocks"
- "Show me the 20 most recent deployed contract modules"
- "What's the current epoch and election information?"

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "concordium mcp server": {
            "concordium": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "--network=host",
                    "concordium-mcp-server"
                ],
                "env": {
                    "CCD_NETWORK": "mainnet",
                    "CCD_PORT": "20000",
                    "CCD_SECURE": "true"
                }
            }
        }
    }
}

McpServers

{
    "concordium": {
        "command": "docker",
        "args": [
            "run",
            "-i",
            "--rm",
            "--network=host",
            "concordium-mcp-server"
        ],
        "env": {
            "CCD_NETWORK": "mainnet",
            "CCD_PORT": "20000",
            "CCD_SECURE": "true"
        }
    }
}

An MCP server that allows AI agents to communicate with the Concordium chain through natural language. Query accounts, blocks, tokens, validators, smart contracts & more without writing any code.

Quick Setup

Docker Setup

Add this to your mcp-server config (Claude Desktop or Cursor):

{
  "mcpServers": {
    "concordium": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--network=host", "concordium-mcp-server"],
      "env": {
        "CCD_NETWORK": "mainnet",
        "CCD_PORT": "20000",
        "CCD_SECURE": "true"
      }
    }
  }
}

Local Setup

For local dev without Docker:

{
  "mcpServers": {
    "concordium": {
      "command": "node",
      "args": ["/zeus/workspace/concordium-mcp-server/dist/index.js"],
      "env": {
        "CCD_NETWORK": "mainnet",
        "CCD_PORT": "20000",
        "CCD_SECURE": "true"
      }
    }
  }
}

Deployment Options

One-Line Setup

Local (auto-configs Claude Desktop):

./scripts/local-deploy.sh

Docker:

./scripts/docker-deploy.sh

Cloud (HTTP):

./scripts/fly-deploy.sh
./scripts/railway-deploy.sh
./scripts/render-deploy.sh

Setup Wizard:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.