README.md
Provides tools for AI assistants to query the Canton Network via the Lighthouse Explorer API.
Lighthouse Explorer MCP Server
An MCP (Model Context Protocol) server for the 5N Lighthouse Explorer API at lighthouse.cantonloop.com.
Overview
This server provides AI assistants (Claude, etc.) with tools to query the Canton Network via the Lighthouse Explorer. It covers CNS (Canton Name Service), governance, validators, parties, contracts, transfers, prices, and more.
No API key required — this is a public API.
API Status Summary
| Status | Count | Description |
|---|---|---|
| ✅ Working | 27 | Tested and working reliably |
| ⚠️ API Limit | 4 | Endpoints don't exist on public API |
| 🐛 API Bug | 1 | Server-side bug (transfer_get) |
Total: 28 tools defined
Installation
# Clone the repo
git clone https://github.com/agenticledger/ClientMCP_LIGHTHOUSE_MCPSERVER.git
cd ClientMCP_LIGHTHOUSE_MCPSERVER
# Install dependencies
npm install
# Build
npm run build
Configuration
No API key required! Just configure Claude Desktop:
Claude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"lighthouse": {
"command": "node",
"args": ["/path/to/lighthouse-mcp-server/dist/index.js"]
}
}
}
Available Tools (28 total)
CNS - Canton Name Service (2 tools)
| Tool | Description |
|---|---|
cns_list |
List CNS records with pagination |
cns_get |
Get a CNS record by domain name |
Contracts (2 tools)
| Tool | Description |
|---|---|
contracts_list |
List contracts with pagination |
contract_get |
Get contract details by contract_id (hex) |
Featured Apps (1 tool)
| Tool | Description |
|---|---|
featured_apps_get |
Get list of featured applications |
Governance (3 tools)
| Tool | Description |
|---|---|
governance_list |
List all governance vote requests |
governance_stats |
Get governance statistics |
governance_get |
Get vote request details by ID |
Party (8 tools)
| Tool | Description |
|---|---|
party_balance |
Get CC balance for a party |
party_burns |
List burns for a party |
party_pnl |
Get profit/loss data |
party_rewards |
List rewards earned |
party_burn_stats |
Aggregated burn stats |
party_reward_stats |
Aggregated reward stats |
party_transfers |
List party transfers |
party_transactions |
List party transactions |
Preapprovals (1 tool)
| Tool | Description |
|---|---|
preapprovals_list |
List preapproval records |
Prices (2 tools)
| Tool | Description |
|---|---|
price_get |
Get latest CC price in USD |
price_history |
Get 24-hour price history |
Rounds (2 tools)
| Tool | Description |
|---|---|
rounds_list |
List consensus rounds |
round_get |
Get round details by number |
Search (1 tool)
| Tool | Description |
|---|---|
search |
Universal search across entities |
Stats (1 tool)
| Tool | Description |
|---|---|
stats_get |
Get chain statistics |
Transactions (2 tools)
| Tool | Description |
|---|---|
transactions_list |
List transactions |
transaction_get |
Get transaction by update ID |
Transfers (1 tool)
| Tool | Description |
|---|---|
transfers_list |
List all transfers |
Validators (2 tools)
| Tool | Description |
|---|---|
validators_list |
Get all validators |
validator_get |
Get validator details by ID |
Usage Examples
Get Network Stats
Use the stats_get tool to see current chain statistics
Check CC Price
Use price_get to get the latest CC price in USD
Search for a Party
Use search with q="Cumberland" to find parties by name
Get Party Balance
Use party_balance with id="Global-Synchronizer-Foundation::1220b086..." to check CC balance
Testing
Run the test suite:
npm test
Project Structure
lighthouse-mcp-server/
├── src/
│ ├── api-client.ts # HTTP client for Lighthouse API
│ ├── tools.ts # MCP tool definitions (28 tools)
│ └── index.ts # Server entry point
├── test/
│ └── test-tools.ts # Automated test suite
├── docs/
│ ├── index.html # Interactive API docs
│ └── TEST-RESULTS.md # Test results
├── dist/ # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md
Known Limitations
Endpoints Not Available (4)
/sv(super validators) - use/validatorsinstead/me(participant info) - not on public API/stats/rounds/latest- endpoint removedtransfer_get- API returns HTTP 500 (bug)
Data Limitations
- CNS: No Canton Name Service records currently exist
- party_balance: Some parties return 500 if no balance data (use Super Validator IDs)
Links
Tools (28)
cns_listList CNS records with paginationcns_getGet a CNS record by domain namecontracts_listList contracts with paginationcontract_getGet contract details by contract_id (hex)featured_apps_getGet list of featured applicationsgovernance_listList all governance vote requestsgovernance_statsGet governance statisticsgovernance_getGet vote request details by IDparty_balanceGet CC balance for a partyparty_burnsList burns for a partyparty_pnlGet profit/loss dataparty_rewardsList rewards earnedparty_burn_statsAggregated burn statsparty_reward_statsAggregated reward statsparty_transfersList party transfersparty_transactionsList party transactionspreapprovals_listList preapproval recordsprice_getGet latest CC price in USDprice_historyGet 24-hour price historyrounds_listList consensus roundsround_getGet round details by numbersearchUniversal search across entitiesstats_getGet chain statisticstransactions_listList transactionstransaction_getGet transaction by update IDtransfers_listList all transfersvalidators_listGet all validatorsvalidator_getGet validator details by IDConfiguration
claude_desktop_config.json
{
"mcpServers": {
"lighthouse": {
"command": "node",
"args": ["/path/to/lighthouse-mcp-server/dist/index.js"]
}
}
}Try it
→Use the stats_get tool to see current chain statistics.
→Use price_get to get the latest CC price in USD.
→Use search with q="Cumberland" to find parties by name.
→Use party_balance with id="Global-Synchronizer-Foundation::1220b086..." to check CC balance.
→List all validators using validators_list.