MCP 服务器

GIWA MCP Server

Enables AI agents to interact with the GIWA blockchain, including balance queries, contract interactions, Flashblocks preconfirmations, Dojang attestations, and UP ID resolution.

README

GIWA MCP Server

MCP (Model Context Protocol) server for the GIWA blockchain — an OP Stack Layer 2 by Upbit/Dunamu.

Enables AI agents and LLMs to interact with GIWA chain: query balances, read/write contracts, use Flashblocks (200ms preconfirmation), manage Dojang attestations, resolve UP ID names, and more.

Features

Core EVM Tools

giwa_get_balance — ETH balance
giwa_get_token_balance — ERC-20 balance
giwa_get_transaction — Transaction details
giwa_get_block / giwa_get_latest_block — Block info
giwa_read_contract / giwa_write_contract — Contract interaction
giwa_estimate_gas — Gas estimation
giwa_transfer_eth / giwa_transfer_erc20 — Token transfers
giwa_multicall — Batched contract reads
giwa_get_logs — Event logs

GIWA Flashblocks (Unique)

giwa_flashblocks_call — ~200ms preconfirmed reads
giwa_flashblocks_get_balance — Pending balance
giwa_flashblocks_get_logs — Pending logs
giwa_flashblocks_simulate — Pre-flight simulation
giwa_flashblocks_estimate_gas — Pending gas estimate

Dojang Attestations

giwa_dojang_get_attestation — Fetch attestation by UID
giwa_dojang_is_valid — Check validity
giwa_dojang_attest — Create attestation
giwa_dojang_revoke — Revoke attestation
giwa_dojang_list_schemas — Known schemas

UP ID (ENS-based naming)

giwa_upid_resolve — Name → address
giwa_upid_reverse — Address → name
giwa_upid_get_text — Text records
giwa_upid_get_contenthash — Content hash

DeFi / Oracles

giwa_get_token_info — Token metadata
giwa_get_weth_balance — WETH balance
giwa_get_allowance — ERC-20 allowance
giwa_get_price_redstone — RedStone price feeds (300+ assets)
giwa_get_price_pyth — Pyth Network prices (on-chain)
giwa_list_known_contracts — Pre-deployed contracts

Account Abstraction (ERC-4337)

giwa_aa_get_nonce — Smart account nonce
giwa_aa_get_deposit — EntryPoint deposit
giwa_aa_estimate_userop_gas — UserOp gas estimate
giwa_aa_build_userop — Build UserOperation
giwa_aa_list_entrypoints — Supported entry points

Installation

npm install giwa-mcp-server

Or run directly with npx:

npx giwa-mcp-server

Configuration

Create a .env file:

GIWA_RPC_URL=https://sepolia-rpc.giwa.io
PRIVATE_KEY=0x...          # Optional: for write operations
BLOCKSCOUT_API_URL=https://sepolia-explorer.giwa.io/api

Usage with Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "giwa": {
      "command": "npx",
      "args": ["giwa-mcp-server"],
      "env": {
        "GIWA_RPC_URL": "https://sepolia-rpc.giwa.io"
      }
    }
  }
}

With private key for write operations:

{
  "mcpServers": {
    "giwa": {
      "command": "npx",
      "args": ["giwa-mcp-server"],
      "env": {
        "GIWA_RPC_URL": "https://sepolia-rpc.giwa.io",
        "PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Usage with Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "giwa": {
      "command": "npx",
      "args": ["giwa-mcp-server"]
    }
  }
}

Development

git clone https://github.com/Alicepoltora/giwa-mcp-server.git
cd giwa-mcp-server
npm install
npm run dev

Build:

npm run build
npm start

Network Info

Property	Value
Network	GIWA Sepolia (testnet)
Chain ID	91342
RPC	https://sepolia-rpc.giwa.io
Flashblocks RPC	https://sepolia-rpc-flashblocks.giwa.io
Explorer	https://sepolia-explorer.giwa.io
Bridge	https://sepolia-bridge.giwa.io
Block Time	1 second
Preconfirmation	~200ms (Flashblocks)