Skip to main content
Glama
pt-act
by pt-act

SolarPlex Arbitrum MCP

npm version License: MIT Live Endpoint

Multi-chain MCP server enabling AI agents to interact with Arbitrum — ERC-8004 identity registration, GMX ecosystem integration, cross-chain reputation via RepuLayer, and 37 governance tools across 6 chains.

Live endpoint: https://solarplex-arbitrum-mcp-production.up.railway.app


Quick Start

Try it now (no install needed)

# Health check
curl https://solarplex-arbitrum-mcp-production.up.railway.app/

# List all tools
curl https://solarplex-arbitrum-mcp-production.up.railway.app/tools

# Chat naturally
curl -X POST https://solarplex-arbitrum-mcp-production.up.railway.app/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Show GMX ETH prices"}'

# Call a tool directly
curl -X POST https://solarplex-arbitrum-mcp-production.up.railway.app/invoke \
  -H "Content-Type: application/json" \
  -d '{"tool": "arbitrum_get_balance", "arguments": {"address": "0xE0DAD8AD88A1139323C90f0F3c6b2612Be9E1815"}}'

Install locally

npm install -g solarplex-arbitrum-mcp

Related MCP server: AgentStamp

What This Is

SolarPlex MCP is the Arbitrum bridge for the SolArPlex AI agent ecosystem. It connects AI agents to:

  • Arbitrum chain — read balances, deploy contracts, register identities (ERC-8004)

  • GMX V2 — real-time prices, markets, open interest from the GMX oracle

  • RepuLayer — cross-chain reputation aggregation (CredDAO + TrustLend + RepuGate)

  • 6 chains total — Solana, Arbitrum, Polygon, BSC, Ethereum, Base

Architecture

AI Agent (Claude, Cursor, etc.)
         │
         ▼
┌─────────────────────────────────┐
│   SolarPlex MCP Server (37)     │
├──────────┬──────────┬───────────┤
│ Solana   │ Arbitrum │ GMX V2    │
│ (6 tools)│ (7 tools)│ (6 tools) │
├──────────┴──────────┴───────────┤
│  Reputation + Governance (18)   │
└─────────────────────────────────┘
         │
    ┌────┼────────────┐
    ▼    ▼            ▼
  Solana  Arbitrum   GMX Oracle
  RPC     + Sepolia  (live API)

All 37 Tools

Arbitrum (7) — Core chain interaction

Tool

Description

arbitrum_register_agent

Register on ERC-8004 identity registry (signed tx)

arbitrum_get_balance

Get ETH balance (viem publicClient)

arbitrum_read_contract

Read from any contract (viem readContract)

arbitrum_write_contract

Write to contract (requires wallet signature)

arbitrum_deploy_stylus

Deploy Stylus (Rust) contract

arbitrum_deploy_solidity

Deploy Solidity contract

arbitrum_bridge_assets

Bridge assets to/from Arbitrum

GMX V2 (6) — Real-time DeFi data

Tool

Description

gmx_get_prices

Token prices from GMX oracle (live API)

gmx_get_positions

Open positions for a wallet

gmx_open_position

Open leveraged position (requires signature)

gmx_close_position

Close position (requires signature)

gmx_get_markets

Available markets (perps/spot)

gmx_get_open_interest

Open interest per market

Reputation (4) — RepuLayer cross-chain bridge

Tool

Description

governance_get_cross_chain_reputation

Unified reputation (Solana + Arbitrum)

governance_get_reputation_breakdown

CredDAO + TrustLend + RepuGate breakdown

governance_compare_reputations

Compare two wallets

governance_get_reputation_trend

Score trend over N days

Governance (6) — Quadratic voting + tiers

Tool

Description

governance_get_reputation

Cross-chain reputation score

governance_get_tier

Governance tier (platinum/gold/silver/bronze)

governance_calculate_voting_power

√(tokens) × (1 + fairscore/50)

governance_get_proposal_status

Proposal status on-chain

governance_create_multichain_proposal

Create on Solana + Arbitrum

governance_get_delegation_efficiency

Delegation efficiency score

Delegate Discovery (4)

Tool

Description

governance_find_delegates

Find delegates by interest

governance_get_delegate_voting_history

Voting history per delegate

governance_calculate_delegation_efficiency

Efficiency between delegator/delegate

governance_suggest_delegation

Optimal delegation strategy

Analytics (4)

Tool

Description

governance_get_analytics

DAO overview (members, proposals, votes)

governance_get_participation_rate

Voter participation rate

governance_get_proposal_success_rate

Proposal pass/fail stats

governance_generate_report

Comprehensive governance report

Solana (6)

Tool

Description

solana_get_balance

SOL balance

solana_get_governance_state

CredDAO governance state

solana_create_proposal

Create governance proposal

solana_cast_vote

Cast vote

solana_get_fairscore

FairScore for wallet

solana_delegate

Delegate voting power


Live Demo: On-Chain Registration

The arbitrum_register_agent tool performs a real signed transaction on Arbitrum Sepolia:

curl -X POST https://solarplex-arbitrum-mcp-production.up.railway.app/invoke \
  -H "Content-Type: application/json" \
  -d '{"tool": "arbitrum_register_agent", "arguments": {"name": "SolarPlex", "description": "Multi-chain governance agent", "skills": ["code", "solana", "arbitrum", "governance"]}}'

Returns:

{
  "status": "confirmed",
  "transactionHash": "0x6803d227a2415a76fa464dec8490ac6dd189f0e399ea7c70d90457a4c3ee922c",
  "explorerUrl": "https://sepolia.arbiscan.io/tx/0x6803d227a2415a76fa464dec8490ac6dd189f0e399ea7c70d90457a4c3ee922c"
}

Configuration

Environment Variables

Variable

Required

Description

ARBITRUM_RPC_URL

Yes

Arbitrum One RPC endpoint

ARBITRUM_SEPOLIA_RPC_URL

Yes

Arbitrum Sepolia RPC endpoint

AGENT_PRIVATE_KEY

For writes

Wallet private key for signing transactions

QUICKNODE_API_KEY

Optional

QuickNode API key

QUICKNODE_SOLANA_ENDPOINT

Optional

Solana QuickNode endpoint

QUICKNODE_ARBITRUM_ENDPOINT

Optional

Arbitrum QuickNode endpoint

Claude Desktop Config

{
  "mcpServers": {
    "solarplex": {
      "command": "solarplex-mcp",
      "env": {
        "ARBITRUM_RPC_URL": "https://your-endpoint.quiknode.pro/...",
        "ARBITRUM_SEPOLIA_RPC_URL": "https://your-sepolia-endpoint.quiknode.pro/..."
      }
    }
  }
}

Requirement

Status

Skill/MCP for AI ↔ Arbitrum

✅ 37 tools across 6 chains

Agent registered on ERC-8004

✅ Real signed tx on Arbitrum Sepolia

Open source

✅ Public GitHub repo

Framework protected

✅ Source in src/, only dist/ published

Published on npm

solarplex-arbitrum-mcp v1.2.0

⭐ GMX integration

✅ Live prices from GMX oracle API

⭐ Cross-chain reputation

✅ RepuLayer bridge (CredDAO + TrustLend + RepuGate)

⭐ Delegate discovery

✅ Interest-based matching with voting history

⭐ Governance analytics

✅ DAO metrics, participation rates, reports

⭐ Live deployed agent

✅ Railway HTTP endpoint


Ecosystem

Part of the SolArPlex multi-chain AI agent network:

  • CredDAO — Solana reputation-weighted governance

  • TrustLend — Under-collateralized lending via FairScore

  • RepuGate — Reputation-gated token launchpad

  • RepuLayer — Cross-chain reputation aggregation

  • AgentxploiTor — Autonomous security auditing

Roadmap: 7-phase ecosystem from reputation building → full cross-chain launch. See solar-plex.netlify.app for details.


Security FAQ

How are private keys handled?

Private keys are never stored, logged, or transmitted. The AGENT_PRIVATE_KEY environment variable is read into memory at runtime only when a write operation is requested. It is used solely to derive a viem WalletClient for signing — the key itself never leaves the server process.

What is the threat model?

Threat

Mitigation

Key extraction from disk

Key is env-only, never written to disk

Unauthorized writes

Rate limited to 5 writes/minute, network allowlist

Mainnet exploits

Mainnet writes explicitly blocked — only Sepolia allowed

Replay attacks

Each transaction uses unique nonce from chain

Key leakage in logs

Operation logging records tx hash, never the key

Compromised server

Ephemeral keys available for session-only operations

Can I use this without exposing my private key?

Yes. Three options:

  1. Read-only mode — Don't set AGENT_PRIVATE_KEY. All read tools (balance, GMX prices, reputation, governance) work without signing.

  2. Ephemeral keys — Call arbitrum_generate_ephemeral_key to create a temporary session key that is never persisted.

  3. Dry-run mode — Add "dryRun": true to any write tool to see the exact transaction data without executing.

What networks are allowed for writes?

Only Arbitrum Sepolia (testnet). Mainnet writes are explicitly blocked in the security layer. This prevents accidental or malicious mainnet transactions.

How does rate limiting work?

Write operations are limited to 5 per minute per server instance. If exceeded, the API returns a 429-style response with retryAfter seconds. This prevents abuse if the endpoint is exposed publicly.

Is the HTTP endpoint authenticated?

The public Railway endpoint is open for demo purposes. For production use, add your own authentication layer (API key, JWT, etc.) in front of the MCP server. The security layer protects against write abuse regardless.

Can I audit the code?

Yes — full source is public at github.com/pt-act/SolarPlex_Arbitrum-MCP. The security module is in src/security.ts.

How do I verify the published build matches the source?

See RELEASE-v1.2.0.md for SHA256 checksums and reproducible build instructions.


License

MIT

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pt-act/SolarPlex_Arbitrum-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server