Injective Server

An MCP (Model Context Protocol) server that gives AI agents full trading capabilities on Injective — perpetual futures, spot transfers, cross-chain bridging, and raw EVM transactions.

Connect it to Claude Desktop or Claude Code and trade with natural language.

---

Tools

Address Utilities

Tool	Description
address_normalize	Accept an inj1... or 0x... address and return both canonical encodings.

Wallets

Tool	Description
wallet_generate	Generate a new Injective wallet. Returns address + mnemonic (shown once).
wallet_import	Import a wallet from a hex private key.
wallet_list	List all wallets in the local keystore (addresses only — no keys).
wallet_remove	Permanently delete a wallet from the keystore.

Markets & Accounts

Tool	Description
market_list	List all active perpetual futures markets.
market_price	Get the current oracle price for a market by symbol (e.g. "BTC").
account_balances	Get bank + subaccount balances. Supports all token types.
account_positions	Get open perpetual positions with unrealized P&L.
token_metadata	Look up symbol, decimals, and type for any denom.

Native USDC and CCTP

Tool	Description
usdc_native_info	Return native Injective USDC metadata, including EVM address, Cosmos denom, decimals, CCTP domain, and contracts.
cctp_supported_chains	Return common Circle CCTP V2 source-chain configs and aliases for native USDC flows into Injective.
cctp_attestation_status	Check Circle Iris attestation status for a CCTP burn transaction. Read-only.
cctp_mint	Submit receiveMessage(message, attestation) on Injective EVM after an attestation is complete. Real transaction.

RFQ

Tool	Description
rfq_constants	Return RFQ contract, gateway, websocket, chain IDs, and default quote collection window for the configured network.
rfq_market_readiness	List active derivative markets and mark which ones match the RFQ quote denom. Read-only.

Frontend Guidance

Tool	Description
frontend_guidance_topics	List read-only frontend guidance topics available from the MCP server.
frontend_guidance	Return guidance for Injective browser trading flows, optionally filtered by topic.

Perpetual Trading

Tool	Description
trade_open	Open a position with a market order (Cosmos signing).
trade_close	Close an open position with a market order (Cosmos signing).
trade_open_eip712	Open a position using EIP-712 Ethereum signing (MetaMask-compatible keys).
trade_close_eip712	Close a position using EIP-712 Ethereum signing (MetaMask-compatible keys).
trade_limit_open	Open a limit order.
trade_limit_orders	List open limit orders.
trade_limit_close	Cancel a limit order by orderHash.
trade_limit_states	Query order states by order hash.

Transfers & Subaccounts

Tool	Description
transfer_send	Send tokens to another Injective address.
subaccount_deposit	Deposit from bank balance into a trading subaccount.
subaccount_withdraw	Withdraw from a trading subaccount back to bank balance.

Bridging

Tool	Description
bridge_withdraw_to_eth	Withdraw to Ethereum via the Peggy bridge (~30 min, fee applies).
bridge_debridge_quote	Get a deBridge DLN quote to any supported chain. Read-only.
bridge_debridge_send	Bridge tokens from Injective to another chain via deBridge DLN.

EVM

Tool	Description
evm_broadcast	Broadcast a raw EVM transaction on Injective EVM.

---

Setup

npm install
npm run build

Connect to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "injective": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/mcp/server.js"],
      "env": {
        "INJECTIVE_NETWORK": "mainnet"
      }
    }
  }
}

Connect to Claude Code

Add to ~/.claude/mcp.json or your project's MCP config:

{
  "mcpServers": {
    "injective": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/mcp/server.js"],
      "env": {
        "INJECTIVE_NETWORK": "mainnet"
      }
    }
  }
}

Set INJECTIVE_NETWORK to "testnet" to use the Injective testnet.

---

Quickstart

Once connected, a typical session looks like:

> List all BTC and ETH perpetual markets
> What's the current price of BTC?
> Show my balances for inj1...
> Deposit 100 USDT into my trading subaccount
> Open a $50 long on BTC/USDT with 5x leverage
> Show my open positions
> Close my BTC position

For limit orders:

> Open a limit buy on ETH at $3200 for $100 notional, 3x leverage
> List my open limit orders
> Cancel order 0xabc...

For bridging:

> Get a deBridge quote to bridge 50 USDT from Injective to Base
> Bridge 50 USDT to 0x... on Base via deBridge

For native USDC and CCTP:

> Show the native Injective USDC denom and CCTP domain
> Check the CCTP attestation status for burn tx 0x...
> Mint the completed CCTP transfer on Injective

For RFQ discovery:

> Show RFQ constants for mainnet
> Which active USDC perp markets are RFQ-ready?

For frontend implementation guidance:

> List Injective frontend guidance topics
> Show frontend guidance for native USDC balance UX
> What should I check before shipping an Injective browser wallet signing flow?

---

Architecture

Claude (MCP client)
       │  tool calls over stdio
       ▼
MCP Server  (src/mcp/server.ts)
       │
       ├── config/       Network config (testnet / mainnet)
       ├── addresses/    Injective/Ethereum address normalization
       ├── keystore/     AES-256-GCM encrypted key storage
       ├── wallets/      Wallet generation and management
       ├── markets/      Market data with in-memory caching
       ├── accounts/     Balances and positions
       ├── usdc/         Native USDC metadata and Circle CCTP helpers
       ├── rfq/          RFQ constants and market readiness
       ├── guidance/     Read-only frontend implementation guidance
       ├── trading/      Perpetual market orders (Cosmos signing)
       ├── evm/eip712    Perpetual market orders (EIP-712 signing)
       ├── orders/       Perpetual limit order lifecycle
       ├── transfers/    Bank transfers and subaccount moves
       ├── bridges/      Peggy + deBridge cross-chain
       └── evm/          Generic Injective EVM tx broadcasting
              │
              ▼
     Injective Chain
     @injectivelabs/sdk-ts

---

Security

• Private keys are never stored in plaintext — AES-256-GCM + scrypt at rest
• Keys live in ~/.injective-agent/keys/ with 0600 permissions
• Claude never sees raw private keys — only addresses and tx hashes
• Wallet passwords are passed as tool parameters and may appear in MCP client logs — avoid reusing passwords from other services

See SECURITY.md for the full security model.

---

Development

npm test                   # unit tests (no network required)
npm run test:integration   # integration tests against testnet
npm run typecheck          # TypeScript type check

---

Token Support

All Injective denom formats are supported:

Type	Format	Example
Native	inj	INJ
Peggy (bridged ERC-20)	peggy0x...	USDT
IBC	ibc/...	ATOM
TokenFactory	factory/inj.../name	—
MTS / Injective EVM ERC-20	erc20:0x...	native USDC

Token metadata (symbol, decimals) is resolved automatically against on-chain registry and cached for the lifetime of the server process.

---

Networks

Network	INJECTIVE_NETWORK
Mainnet	mainnet
Testnet	testnet

Testnet faucet: https://testnet.faucet.injective.network/