Skip to main content
Glama

arcium-mcp — MCP Server for Arcium Confidential Computing

Connects AI agents (Claude, GPT, any MCP client) to the Arcium encrypted computation network on Solana.

Status

Alpha. Full MCP server with 19 tools across 4 categories. Network Explorer and Encryption Engine use the real Arcium SDK. App Templates implement the full encrypt → submit → await → decrypt pipeline (requires deployed MXE programs and wallet). Supports both stdio and HTTP/SSE transport.

Related MCP server: Solana AI Terminal

Architecture

AI Agent  <-->  MCP Protocol  <-->  arcium-mcp-server  <-->  Arcium Network (Solana)
                (stdio or HTTP)          |
                                @arcium-hq/client + reader

Tools (19 across 4 categories)

Network Explorer (7) — read-only, no wallet

Tool

Description

arcium_list_mxes

List all MXE execution environments

arcium_get_mxe_info

Detailed MXE info

arcium_list_clusters

List computation clusters

arcium_get_cluster_info

Cluster details

arcium_list_nodes

List ARX nodes

arcium_get_node_info

Node details

arcium_network_stats

Aggregate stats

Encryption Engine (4) — client-side, no transactions

Tool

Description

arcium_generate_keypair

x25519 keypair

arcium_get_mxe_pubkey

Fetch MXE public key for ECDH

arcium_encrypt_values

Encrypt with RescueCipher

arcium_decrypt_result

Decrypt computation output

Computation Manager (4) — inspect, track, and manage computations

Tool

Description

arcium_get_comp_definition

Circuit details

arcium_check_computation

Check tx status

arcium_await_finalization

Wait for computation to finalize

arcium_list_mempool

List pending computations

App Templates (4) — full execution flow with deployed programs

Tool

Description

arcium_play_coinflip

Encrypted coin flip

arcium_play_rps

Rock-paper-scissors

arcium_sealed_bid

Sealed auction bid

arcium_private_vote

Encrypted DAO vote

Quick Start

npm install
npm run build
npm start

Environment Variables

Variable

Description

Default

SOLANA_RPC_URL

Solana RPC endpoint

https://api.mainnet-beta.solana.com

ARCIUM_CLUSTER_OFFSET

Cluster offset

0

ARCIUM_WALLET_PRIVATE_KEY

Base58 or JSON array Solana keypair

(none — read-only mode)

ARCIUM_MCP_TRANSPORT

Transport mode: stdio or http

stdio

ARCIUM_MCP_PORT

HTTP port (when transport=http)

3000

ARCIUM_COINFLIP_PROGRAM

Coinflip MXE program ID

(disabled)

ARCIUM_RPS_PROGRAM

RPS MXE program ID

(disabled)

ARCIUM_AUCTION_PROGRAM

Auction MXE program ID

(disabled)

ARCIUM_VOTING_PROGRAM

Voting MXE program ID

(disabled)

Claude Desktop config (stdio)

{
  "mcpServers": {
    "arcium": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "SOLANA_RPC_URL": "https://api.devnet.solana.com"
      }
    }
  }
}

HTTP/SSE mode (for hosted usage)

ARCIUM_MCP_TRANSPORT=http ARCIUM_MCP_PORT=3000 npm start
# MCP endpoint: http://localhost:3000/mcp
# Health check: http://localhost:3000/health

Development (Ralph Wiggum Method)

This project uses the Ralph Wiggum method for AI-driven iterative development.

# Planning mode — analyze specs vs code, generate task list
./loop.sh plan

# Build mode — implement one task per iteration, commit, repeat
./loop.sh 20

Key files:

  • specs/* — Requirement specs per topic of concern

  • IMPLEMENTATION_PLAN.md — Prioritized task list (generated/updated by Ralph)

  • AGENTS.md — Operational guide for build/test commands

  • PROMPT_plan.md / PROMPT_build.md — Loop instructions

License

MIT

Available Tools

19 tools
arcium_await_finalizationA

Wait for an encrypted computation to finalize. Returns the finalization transaction signature. Requires wallet (ARCIUM_WALLET_PRIVATE_KEY env var).

Inputs: program_id (required), computation_offset (required), commitment.

arcium_check_computationB

Check computation status by analyzing the Solana transaction signature.

Inputs: tx_signature (required).

arcium_decrypt_resultA

Decrypt an encrypted computation result using your private key and the result nonce.

Inputs: nonce (required), mxe_public_key (required), encrypted_result (required), client_private_key (required).

arcium_encrypt_valuesB

Encrypt numeric values using Arcium's RescueCipher via ECDH shared secret. Returns ciphertext ready for MPC computation.

Inputs: values (required), mxe_public_key (required), client_private_key (required).

arcium_generate_keypairA

Generate a new x25519 encryption keypair for Arcium. IMPORTANT: The private key is returned once — store it securely.

Inputs: no named parameters.

arcium_get_cluster_infoB

Get detailed info about a specific cluster including its nodes and capacity.

Inputs: cluster_address (required).

arcium_get_comp_definitionA

Get details about a computation definition (circuit) including finalization authority and callback settings.

Inputs: program_id (required), instruction_name (required).

arcium_get_mxe_infoB

Get detailed information about a specific MXE including authority, cluster, and computation definitions.

Inputs: mxe_address (required).

arcium_get_mxe_pubkeyB

Fetch the public encryption key of a specific MXE program for ECDH key exchange.

Inputs: program_id (required).

arcium_get_node_infoA

Get detailed info about a specific ARX node including its encryption pubkey and cluster memberships.

Inputs: node_address (required).

arcium_list_clustersA

List all computation clusters. Clusters are groups of ARX nodes that execute MPC computations together.

Inputs: no named parameters.

arcium_list_mempoolB

List pending computations in an MXE program's mempool. Shows computations waiting to be processed by ARX nodes.

Inputs: program_id (required).

arcium_list_mxesA

List all MXE (Multi-party computation eXecution Environments) on the Arcium network. Returns addresses, authorities, cluster assignments, and computation definitions.

Inputs: no named parameters.

arcium_list_nodesB

List all ARX nodes in the Arcium network. ARX nodes process encrypted data.

Inputs: no named parameters.

arcium_network_statsA

Get aggregate network statistics: total MXEs, clusters, nodes.

Inputs: no named parameters.

arcium_play_coinflipB

Play an encrypted coin flip. Your choice is encrypted and compared against MPC randomness.

Inputs: choice (required).

arcium_play_rpsB

Play encrypted rock-paper-scissors. Moves are compared inside MPC — neither player sees the other's move.

Inputs: move (required), game_id.

arcium_private_voteA

Cast an encrypted vote in a DAO governance proposal. Hidden until voting period ends.

Inputs: vote (required), proposal_address (required).

arcium_sealed_bidA

Submit an encrypted sealed bid to an onchain auction. Bid stays hidden until close.

Inputs: bid_amount (required), auction_address (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 19 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: key generation, encryption/decryption, network info (clusters, nodes, MXEs), computation status, and specific applications (coinflip, RPS, vote, bid). No two tools have overlapping purposes; even similar-sounding tools like get vs list are clearly scoped to individual vs aggregate.

    Naming Consistency5/5

    All tool names follow a consistent `arcium_verb_noun` pattern using snake_case. Verbs are informative (encrypt, decrypt, generate, get, list, play, await, check) and nouns clearly indicate the target. No mixed conventions or vague names.

    Tool Count5/5

    19 tools is well-scoped for a platform offering key management, encryption/decryption, network queries, computation monitoring, and interactive MPC games. Each tool serves a clear purpose without redundancy, and the count feels complete for the advertised features.

    Completeness3/5

    The tool surface covers querying network state, encryption/decryption, and predefined games/voting, but lacks explicit tools to initiate custom computations or submit encrypted data for MPC processing. This gap means agents cannot perform the full lifecycle of a custom computation using the server alone.

    Related MCP Connectors

    Related MCP Servers