# CC Explorer MCP Server

An MCP (Model Context Protocol) server for interacting with the **Canton Network Explorer API** at [pro.ccexplorer.io](https://pro.ccexplorer.io).

## Overview

This server provides AI assistants (Claude, etc.) with tools to query the Canton Network blockchain explorer via the CC Explorer Pro API.

**API Version:** 2.9.0  
**Base URL:** https://pro.ccexplorer.io/api  
**Auth:** x-api-key header

## Installation

```bash
# Clone the repo
git clone https://github.com/agenticledger/ClientMCP_CCEXPLORER_MCPSERVER.git
cd ClientMCP_CCEXPLORER_MCPSERVER

# Install dependencies
npm install

# Build
npm run build
```

## Configuration

### Get an API Key

Contact NodeFortress / CC Explorer Pro for API access.

### Set Environment Variable

```bash
export CCEXPLORER_API_KEY=your_api_key_here
```

### Claude Desktop Configuration

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "ccexplorer": {
      "command": "node",
      "args": ["/path/to/ccexplorer-mcp-server/dist/index.js"],
      "env": {
        "CCEXPLORER_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Available Tools (14)

### Consensus
| Tool | Description |
|------|-------------|
| `consensus_get` | Get latest consensus block and validator set |

### Contracts
| Tool | Description |
|------|-------------|
| `contract_get` | Get details of a specific contract by ID |
| `contract_updates_list` | List updates involving a specific contract |

### Updates
| Tool | Description |
|------|-------------|
| `updates_list` | List ledger updates |
| `update_get` | Get a specific ledger update by ID |
| `party_updates_list` | List updates involving a specific party |

### Rounds
| Tool | Description |
|------|-------------|
| `round_current` | Get the current round number |

### Governance
| Tool | Description |
|------|-------------|
| `governance_list` | List all governance votes (in progress and closed) |
| `governance_get` | Get a governance vote by tracking CID |

### Overview
| Tool | Description |
|------|-------------|
| `overview_get` | Network overview: validators, supply, consensus height, open votes |

### Parties
| Tool | Description |
|------|-------------|
| `party_get` | Get details of a specific party (wallet) by ID |

### Search
| Tool | Description |
|------|-------------|
| `search` | Search for parties, updates, or other entities |

### Validators
| Tool | Description |
|------|-------------|
| `super_validators_list` | List super validators and their reward weights |
| `validators_list` | List all active validator licenses |

## Usage Examples

### Get Network Overview

```
Use the overview_get tool to see network stats including active validators, supply, and open votes
```

### Search for a Party

```
Use the search tool with query="party_id_here" to find information
```

### List Governance Votes

```
Use governance_list to see all in-progress and closed governance votes
```

### Get Current Round

```
Use round_current to get the current network round number
```

## Resources

The server also provides informational resources:

| Resource URI | Description |
|--------------|-------------|
| `ccexplorer://api-info` | Overview of available endpoints |

## License

MIT

## Author

Ore Phillips ([@oregpt](https://github.com/oregpt))

## Links

- [CC Explorer Pro](https://pro.ccexplorer.io) - Canton Network Explorer
- [Canton Network](https://canton.network) - Learn about Canton