The Seitrace Insights MCP Server provides natural-language access to Seitrace Insights API through a resource-based Model Context Protocol interface with five core tools:
• Discover Resources: List available resources like insights_address
, insights_erc20
, insights_erc721
, insights_native
, and general_faucet
• List Actions: Enumerate available actions for specific resources
• Fetch Schemas: Retrieve JSON Schema for resource actions to understand required input parameters
• Invoke Actions: Execute resource actions with validated payloads to retrieve insights data or manipulate resources
• Generate Code Snippets: Create language-specific code examples (JavaScript, Python, Node.js, Java) for programmatic integration
Key Features:
Input validation with clear error messaging
Secure API key handling via environment variables (
SECRET_APIKEY
)Integration with MCP-compatible clients like VS Code extensions (Continue, Cline)
Self-describing architecture for discoverability
Developer faucet access for testing
Communication over stdio with MCP clients
Generates JavaScript code snippets for interacting with blockchain APIs
Required runtime environment for executing the MCP server
Used for package management and quick deployment via npx
Seitrace MCP
The essential MCP (Model Context Protocol) server for the Sei blockchain.
Available tools 🧰
Five tools that form the resource-based interface (use in order 1→2→3→4):
list_resources
— list available resources (start here)list_resource_actions
— list actions for a resourceget_resource_action_schema
— REQUIRED get the JSON Schema for an action before invokinginvoke_resource_action
— invoke an action with payload matching the schemaget_resource_action_snippet
— (optional) generate a code snippet to perform a resource action in the specified language
Supported resources
General
general_faucet
- enable requesting faucet for developersgeneral_rpc_lcd
- enable general rpc/lcd inquiries for the agents, and execute the rpc/lcd requests based on the demandsgeneral_associations
— query hybrid associations (EOA/assets/txs) across EVM and native Sei. Returns simplified pointer/pointee fields when applicable.
Insights
insights_address
— Query address data: details, transactions, token transfers.insights_erc20
— Query ERC-20 tokens: info, balances, transfers, holders.insights_cw20
— Query CW20 tokens: info, balances, transfers, holders.insights_native
— Query native tokens: info, transfers, balances, holders.insights_ics20
— Query ICS20 tokens: info, transfers, balances, holders.insights_erc721
— Query ERC-721 tokens: info, holders, instances, balances, transfers.insights_erc1155
— Query ERC-1155 tokens: info, holders, instances, balances, transfers.insights_cw721
— Query CW721 tokens: info, instances, balances, holders, transfers.insights_smart_contract
— Query smart contract details.insights_assets
— Search official assets by name/symbol/identifier and get asset details by identifier. Uses Sei gateway endpoints; search is performed offline over the fetched assets list.insights_earnings
— Search/list earnings pools (APR/APY) for pacific-1 and fetch a pool by address. Returns simplified fields: name, address, url, image, provider, tvl, apr, apy.insights_transactions
— Query transaction details by hash via gateway (pacific-1, atlantic-2, arctic-1).
Smart Contract
smart_contract
— Query smart contract state via Multicall3, search verified contracts, or download smart contract ABI from Seitrace (pacific-1, atlantic-2, arctic-1).
Getting started
Make sure you obtain an API Key for free here
Use with general AI Models (streamablehttp, sse)
Make sure you are using the correct endpoints
StreamableHTTP
SSE
Use with VSCode variants, Claude Desktop / Cursor 💻
See mcp
Using with an MCP Client 🤝
Configure your MCP client to launch the compiled server binary:
- Command:
npx
- Args:
["-y", "@seitrace/mcp"]
- Env:
SECRET_APIKEY
,API_BASE_URL
(optional)
Once connected, the client will call tools/list
, which returns exactly five tools representing the resource interface.
Highlights ✨
What MCP provides to end users and assistants:
- Natural‑language access to Seitrace insights. The assistant performs API calls on your behalf.
- Self‑describing tool flow: enumerate actions, retrieve the input schema, then invoke.
- Input validation and clear error messages using per‑action JSON Schemas.
- Concise discovery: minimal list output; detailed payloads only when invoking actions.
- Integration with MCP‑enabled VS Code extensions (e.g., Continue, Cline).
- Simple, secure API key handling via environment variables (sent as
x-api-key
). - Quick start via npx:
npx -y @seitrace/mcp
.
Typical Flow 🔁
Using the MCP SDK, drive the resource-based flow via the five tools. Important: Always follow this sequence, especially step 3:
The server validates payload
against the action’s schema and returns a pretty-printed JSON body when applicable.
Requirements 🔧
- Node.js 20+
- A Seitrace Insights API key (optional for discovery, required for most live calls), obtain it here
Install 📦
Configure 🔐
Copy .env.example
to .env
and set your values as needed.
Environment variables:
API_BASE_URL
(optional) — defaults tohttps://seitrace.com/insights
SECRET_APIKEY
— Seitrace API key; used to set headerx-api-key
Build and Run 🏃
This server is designed to be launched by an MCP-compatible client (e.g., via a command/args configuration). It communicates over stdio.
End-to-End Test ✅
Run the E2E to verify the root resource flow and (optionally) a live positive-call:
Troubleshooting 🛠️
Make sure you run our e2e test to see the common errors we covered.
- E2E:
npm run test:e2e
(optionalE2E_DEBUG=1
for[E2E]
logs). - Node: Use v20+.
Contributing 🤝
- Keep
tools/list
output compact. Do not embed per-action details there—fetch them viagetResourceActionSchema
. - New endpoints should appear under the correct resource; root tool methods should provide discovery and invocation consistently.
- Prefer small, focused modules in
src/lib/
for shared logic.
License 📄
See LICENSE
Support 📨
Please shoot emails to dev@cavies.xyz
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Enables natural language access to blockchain data and insights through the Seitrace API. Supports querying address details, token information (ERC-20, ERC-721, ERC-1155, CW20, CW721), transaction data, and smart contract details across multiple blockchain networks.
Related MCP Servers
- AsecurityAlicenseAqualityFacilitates interaction with Ethereum blockchain data via Etherscan's API, providing real-time access to balances, transactions, token transfers, contract ABIs, gas prices, and ENS name resolutions.Last updated -1224MIT License
- AsecurityAlicenseAqualityProvides Ethereum blockchain data tools via Etherscan's API, enabling users to check ETH balances, view transactions, track token transfers, fetch contract ABIs, monitor gas prices, and resolve ENS names.Last updated -121MIT License
- AsecurityAlicenseAqualityProvides tools for AI assistants to interact with the Ethereum blockchain through standard JSON-RPC methods, enabling queries for account balances, gas prices, and smart contract code.Last updated -310MIT License
- -securityFlicense-qualityA Solana blockchain interaction server that allows AI tools to query blockchain data using natural language, access structured token information, and generate human-readable explanations of complex blockchain concepts.Last updated -8