MCP Server - Sei Docs

The Sei Model Context Protocol (MCP) Server lets AI assistants interact with Sei networks through natural language. It is built on the Model Context Protocol standard and gives AI coding assistants blockchain tools.

The Sei MCP Server is open source. Contribute at github.com/sei-protocol/sei-js. @sei-js/mcp-server@1 requires Node.js 20 or newer.

The server starts in read-only mode. It hides wallet tools that sign or broadcast unless you set WALLET_MODE=private-key and PRIVATE_KEY on the default stdio transport.

What is MCP?

The Model Context Protocol is an open standard that connects AI systems with external tools and data sources. With MCP, an AI system can:

Access real-time data from external services
Execute functions and operations
Keep context across interactions
Use specialized capabilities beyond its base training

The Sei MCP Server uses this protocol to bring blockchain functionality directly to your AI assistant.

Capabilities

Category	Features
Account management	Wallet addresses, balance queries, contract verification
Token operations	SEI, ERC-20, ERC-721, and ERC-1155 reads. Transfers and approvals need wallet mode.
Blockchain data	Block information, transaction details, network status
Smart contracts	State queries. Function execution and contract deploys need wallet mode.
Networks	Sei Mainnet, Sei Testnet

Setup guide

Cursor
Windsurf
Claude Desktop
Claude CLI

Cursor setup

Open Settings

Go to Cursor → Settings → Cursor Settings → MCP.

Configure server

Click Add new Global MCP server. Then add this configuration to mcp.json:

{
  "mcpServers": {
    "sei-mcp-server": {
      "command": "npx",
      "args": ["-y", "@sei-js/mcp-server"]
    }
  }
}

Restart

Restart Cursor to activate the MCP server. Cursor shows a notification when the server is ready.

Windsurf setup

Open Settings

Go to Windsurf → Settings → Windsurf Settings → Cascade.

Add configuration

Add the Sei MCP Server to your configuration:

{
  "mcpServers": {
    "sei": {
      "command": "npx",
      "args": ["-y", "@sei-js/mcp-server"]
    }
  }
}

Activate

Save the configuration and restart Windsurf. The server loads automatically.

Claude Desktop setup

Install Claude

Download Claude Desktop from Anthropic.

Edit configuration

Open Settings → Developer → Edit Config, and add this configuration:

{
  "mcpServers": {
    "sei": {
      "command": "npx",
      "args": ["-y", "@sei-js/mcp-server"]
    }
  }
}

Restart

Save the configuration and restart Claude Desktop to enable the Sei tools.

Claude CLI setup

Install CLI

npm install -g @anthropic-ai/claude-code

Add server

claude mcp add sei-mcp-server npx @sei-js/mcp-server

Start session

claude

The Sei MCP Server activates automatically in your session.

Private key setup

The server starts in read-only mode. To enable wallet tools over the default stdio transport, add both variables to the server’s env configuration:

{
  "mcpServers": {
    "sei": {
      "command": "npx",
      "args": ["-y", "@sei-js/mcp-server"],
      "env": {
        "WALLET_MODE": "private-key",
        "PRIVATE_KEY": "0x_your_private_key_here"
      }
    }
  }
}

Create a dedicated wallet for MCP operations. Never use your main wallet’s private key. The 0x prefix on PRIVATE_KEY is optional. HTTP transports block wallet mode. If private-key mode is misconfigured, startup fails. The server does not silently disable wallet tools.

Export your private key from your wallet:

Look for Export Private Key or Show Private Key in the wallet settings.
Fund the wallet with small amounts for testing.

Features

With the Sei MCP Server, your AI assistant can:

Query account balances, tokens, NFTs, blocks, and transactions (read-only)
Search the official Sei docs, including @sei-js references (search_docs)
Monitor network status for Sei Mainnet and Sei Testnet
Execute token transfers, NFT transfers, contract writes, and deploys when wallet mode is enabled on stdio

Available tools

Read-only tools stay registered when wallet mode is disabled. The server hides signing and broadcasting tools until you enable wallet mode on stdio. Network arguments accept sei, sei-testnet, 1329, 1328, 0x531, or 0x530. The server rejects unknown networks. Chain-info responses omit RPC URLs. search_docs queries docs.sei.io. There is no search_sei_js_docs tool.

Core operations

Tool	Purpose	Example	Wallet mode
`search_docs`	Search the official Sei docs	”How do I use the staking precompile?”	No
`get_supported_networks`	List supported networks	”Which Sei networks are available?”	No
`get_chain_info`	Network chain ID and latest block	”Show Sei Mainnet info”	No
`get_balance`	Native SEI balance	”Check balance of 0x123…”	No
`is_contract`	Verify a contract address	”Is 0x789… a contract?”	No
`read_contract`	Call a read-only contract function	”Read DEX reserves”	No
`estimate_gas`	Estimate gas for a call	”How much gas does this transfer need?”	No
`get_address_from_private_key`	Address for the configured key	”What is my wallet address?”	Required
`transfer_sei`	Send SEI	”Send 1 SEI to 0x456…”	Required
`write_contract`	Call a state-changing contract function	”Call transfer on this contract”	Required
`deploy_contract`	Deploy bytecode	”Deploy this contract”	Required

Token management

Tool	Purpose	Example	Wallet mode
`get_token_info`	ERC-20 metadata	”Get USDC token info”	No
`get_token_balance`	ERC-20 balance (`tokenAddress`, `ownerAddress`)	“Check my USDC balance”	No
`transfer_token`	ERC-20 transfer (`tokenAddress`, `toAddress`, `amount`)	“Send 100 USDC to 0x123…”	Required
`approve_token_spending`	ERC-20 approval	”Approve a DEX for USDC”	Required

Use get_token_balance and transfer_token. The server also registers these aliases for backward compatibility:

get_erc20_balance and get_token_balance_erc20 behave like get_token_balance, but they name the holder argument address instead of ownerAddress.
transfer_erc20 is transfer_token under a different name, with the same arguments.

NFT and ERC-1155

Tool	Purpose	Example	Wallet mode
`get_nft_info`	ERC-721 metadata	”Show NFT #123 details”	No
`check_nft_ownership`	ERC-721 owner check (`ownerAddress` in, boolean out). Failures return an error instead of `false`.	”Does 0x… own NFT #456?”	No
`get_nft_balance`	ERC-721 collection balance	”How many NFTs do I own?”	No
`get_erc1155_balance`	ERC-1155 balance	”Check my ERC-1155 balance”	No
`get_erc1155_token_uri`	ERC-1155 token URI	”Get the URI for this ERC-1155”	No
`transfer_nft`	ERC-721 `safeTransferFrom`	”Send NFT #789 to 0xABC…”	Required
`transfer_erc1155`	ERC-1155 transfer	”Send this ERC-1155 to 0xABC…”	Required

Failed NFT ownership lookups propagate as errors instead of reporting false. ERC-721 transfers use safeTransferFrom, so contract recipients must implement onERC721Received.

Blocks and transactions

Tool	Purpose	Example	Wallet mode
`get_block_by_number`	Block by number	”Get block 12345”	No
`get_latest_block`	Latest block	”Get the latest block”	No
`get_transaction`	Transaction data	”Show tx 0xTXID…”	No
`get_transaction_receipt`	Transaction receipt	”Get the receipt for 0xTXID…”	No

AI prompts

These prompts are always available, including in read-only mode:

explore_block

Analyze block data

analyze_transaction

Break down transaction details

analyze_address

Inspect an address and its activity

analyze_token

Summarize token metadata and balances

interact_with_contract

Guide you through a contract call

explain_evm_concept

Explain an EVM concept in context

compare_networks

Compare Sei Mainnet and Sei Testnet

These prompts require wallet mode on the stdio transport:

my_wallet_address

Return the configured wallet address

send_transaction_guidance

Guide you through sending a transaction

token_transfer_guidance

Guide you through a token transfer

Usage examples

Query balance

“What is my SEI balance?”Calls get_balance and returns the wallet balance and address.

Send transaction

“Send 1 SEI to 0x742d35Cc6634C0532925a3b844Bc454e4438f44e”Calls transfer_sei and returns the transaction hash. Requires wallet mode.

Contract analysis

“Is 0x3894085ef7ff0f0aedf52e2a2704928d1ec074f1 a contract?”Calls is_contract and identifies the contract type and metadata.

Resource URIs

Access blockchain data through standardized URIs:

# Network data
evm://sei/chain
evm://sei-testnet/chain

# Block information
evm://sei/block/latest
evm://sei/block/12345

# Transactions
evm://sei/tx/0xabc123...

# Token data
evm://sei/token/0x3894085ef7ff0f0aedf52e2a2704928d1ec074f1
evm://sei/token/0x389.../balanceOf/0x742d...

# NFT data
evm://sei/nft/0xNFT_ADDRESS/123
evm://sei/nft/0xNFT_ADDRESS/123/isOwnedBy/0x742d...

Configuration

Client-launched servers (npx from Cursor, Claude Desktop, or a similar client) read variables from the MCP client’s env object. The server loads a project-local .env file only when the process starts in a directory that contains one, such as a local checkout.

# Default: read-only mode
WALLET_MODE=disabled

# Optional RPC overrides
MAINNET_RPC_URL=https://your-mainnet-rpc.example
TESTNET_RPC_URL=https://your-testnet-rpc.example

# Optional wallet tools for stdio transport only
# WALLET_MODE=private-key
# PRIVATE_KEY=0x_your_private_key_here

Variable	Default	Notes
`WALLET_MODE`	`disabled`	`private-key` enables signing tools on stdio
`PRIVATE_KEY`	unset	Required when `WALLET_MODE=private-key`. The `0x` prefix is optional
`MAINNET_RPC_URL`	public mainnet RPC	Used only for upstream connections
`TESTNET_RPC_URL`	public testnet RPC	Used only for upstream connections
`SERVER_TRANSPORT`	`stdio`	`streamable-http` or `http-sse` for HTTP
`SERVER_HOST`	`localhost`	HTTP listener host
`SERVER_PORT`	`8080`	HTTP listener port
`SERVER_PATH`	`/mcp`	HTTP endpoint path
`SSE_MAX_SESSIONS`	`100`	Legacy SSE concurrent session cap
`STREAMABLE_HTTP_MAX_REQUESTS`	`100`	Streamable HTTP concurrent request cap

The server does not support CLI flags such as --http. Set SERVER_TRANSPORT instead. For the current reference, run npx -y @sei-js/mcp-server --help.

HTTP server mode

Streamable HTTP is the HTTP transport for new integrations:

SERVER_TRANSPORT=streamable-http \
SERVER_HOST=127.0.0.1 \
SERVER_PORT=8080 \
npx -y @sei-js/mcp-server

Connect to http://127.0.0.1:8080/mcp. To change the listener, set SERVER_HOST, SERVER_PORT, and SERVER_PATH. Legacy HTTP/SSE is available for older clients:

SERVER_TRANSPORT=http-sse \
SERVER_HOST=127.0.0.1 \
npx -y @sei-js/mcp-server

For http-sse, GET {SERVER_PATH} is the event stream. Clients POST messages to {SERVER_PATH}/message?sessionId=<id>.

For local use, bind to 127.0.0.1. Put any public exposure behind an authenticating reverse proxy. HTTP transports do not authenticate callers or validate Origin or Host. They also reject wallet mode.

Security guidelines

Use a dedicated wallet with only the funds you need for testing. Set PRIVATE_KEY through environment variables or the MCP client’s env object. Never commit it. Review the transaction history of that wallet regularly.

For anything beyond a throwaway test wallet, treat the signing key as production infrastructure:

Cap the value that any single transaction can move.
Hold funds in a multi-signature wallet, and let the agent operate a low-balance hot wallet.
Restrict the agent to an allowlist of contract addresses.
Rate-limit the tools that sign or broadcast.

Troubleshooting

Connection issues: Verify that Node.js 20 or later is installed. Then restart your AI assistant. Private key errors: Set WALLET_MODE=private-key. Make sure the key is a valid 32-byte secp256k1 key (the 0x prefix is optional). Use the default stdio transport. Cursor: The model returned an error. Try disabling the MCP servers, or switch models: Disable Auto in the model menu. Then select a specific model, for example claude-4-sonnet.

​What is MCP?

​Capabilities

​Setup guide

​Cursor setup

​Windsurf setup

​Claude Desktop setup

​Claude CLI setup

​Private key setup

​Features

​Available tools

​Core operations

​Token management

​NFT and ERC-1155

​Blocks and transactions

​AI prompts

explore_block

analyze_transaction

analyze_address

analyze_token

interact_with_contract

explain_evm_concept

compare_networks

my_wallet_address

send_transaction_guidance

token_transfer_guidance

​Usage examples

Query balance

Send transaction

Contract analysis

​Resource URIs

​Configuration

​HTTP server mode

​Security guidelines

​Troubleshooting

What is MCP?

Capabilities

Setup guide

Cursor setup

Windsurf setup

Claude Desktop setup

Claude CLI setup

Private key setup

Features

Available tools

Core operations

Token management

NFT and ERC-1155

Blocks and transactions

AI prompts

Usage examples

Resource URIs

Configuration

HTTP server mode

Security guidelines

Troubleshooting