Seitrace Insights MCP Server

Seitrace Insights MCP Server 🚀

A Model Context Protocol (MCP) server that exposes the Seitrace Insights API as model-friendly tools. It now advertises five focused tools that implement a resource-based interface so LLMs can discover resources, list actions, fetch schemas, invoke them, and generate code snippets. Grouped tools (e.g., erc20, native) remain available for compatibility but are not listed.

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.

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: node
Args: build/index.js
Env (optional): SECRET_APIKEY, API_BASE_URL

Once connected, the client will call tools/list, which returns exactly five tools representing the resource interface.

Available tools 🧰

Primary entrypoint: five tools that form the resource-based interface:

list_resources — list available resources
list_resource_actions — list actions for a resource
get_resource_action_schema — get the JSON Schema for an action
invoke_resource_action — invoke an action with payload
get_resource_action_snippet — generate a code snippet to perform a resource action in the specified language, for example, a javascript snippet to call the action with the required parameters

Flow: list resources -> list actions for a resource -> get action schema -> invoke action or generate a code snippet.

Common resources include:

address — address detail, transactions, and token transfers.
erc20 — ERC‑20 token information, balances, transfers, and holders.
erc721 — ERC‑721 token information, transfers, and holders.
erc1155 — ERC‑1155 token information, instances, and holders.
cw20 — CW20 token information, balances, transfers, and holders.
cw721 — CW721 token information, transfers, and holders.
ics20 — ICS‑20 (IBC fungible) transfer information.
native — native token information and statistics.
smart_contract — smart contract detail.

Typical Flow 🔁

Using the MCP SDK, drive the resource-based flow via the five tools:

// 1) Discover available resources
const resources = await client.callTool({ name: 'list_resources', arguments: {} });
// -> { resources: ['erc20', 'erc721', 'native', ...] }

// 2) List actions for a resource
const actions = await client.callTool({ name: 'list_resource_actions', arguments: { resource: 'erc20' } });
// -> { resource: 'erc20', actions: [{ name, description }, ...] }

// 3) Get the JSON Schema for a specific action
const schema = await client.callTool({ name: 'get_resource_action_schema', arguments: { resource: 'erc20', action: 'get_erc20_token_info' } });
// -> { resource: 'erc20', action: 'get_erc20_token_info', schema }

// 4) Invoke the action with its payload
const res = await client.callTool({ name: 'invoke_resource_action', arguments: { resource: 'erc20', action: 'get_erc20_token_info', payload: { chain_id: 'pacific-1', contract_address: '0x...' } } });
// res.content[0].text -> "API Response (Status: 200):\n{ ... }"

// 5) Optionally, generate a code snippet for an action
const snippet = await client.callTool({ name: 'get_resource_action_snippet', arguments: { resource: 'erc20', action: 'get_erc20_token_info', language: 'node' } });
// -> { resource, action, language, snippet }

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

Quick start (npx) ⚡

If you just want to run the server, use the one‑liner:

npx -y @seitrace/mcp

You can set environment variables such as SECRET_APIKEY and API_BASE_URL in your shell or inline.

Install 📦

npm install

Configure 🔐

Copy .env.example to .env and set your values as needed.

Environment variables:

API_BASE_URL (optional) — defaults to https://seitrace.com/insights
SECRET_APIKEY — Seitrace API key; used to set header x-api-key

Build and Run 🏃

# Type-check and compile to build/
npm run build

# Run the MCP server over stdio (used by MCP clients)
npm start

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:

# Optionally provide your API key so the positive path runs
SEITRACE_API_KEY=your_key_here npm run test:e2e

Troubleshooting 🛠️

Validation errors: If invoke_resource_action returns “Invalid arguments…”, call get_resource_action_schema and ensure your payload follows the schema.
Unknown action: You’ll get an error that includes the available actions. Use list_resource_actions to discover the right name.
401/403 responses: Set SECRET_APIKEY with a valid Seitrace key.
Network issues: Ensure API_BASE_URL is reachable from your environment.
Node version: Use Node 20+ as required in package.json.

Contributing 🤝

Keep tools/list output compact. Do not embed per-action details there—fetch them via get_resource_action_schema.
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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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.

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

MCP Etherscan Server
crazyrabbitLTC
A
security
A
license
A
quality
Facilitates 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 -
6
16
23
TypeScript
MIT License
MCP Etherscan Server
5ajaki
A
security
A
license
A
quality
Provides 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 -
6
16
1
TypeScript
MIT License
Ethereum RPC MCP Server
0xKoda
A
security
A
license
A
quality
Provides 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 -
3
8
JavaScript
MIT License
Solana Model Context Protocol (MCP) Server
0xWizzzz
-
security
F
license
-
quality
A 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 -
9
Python

View all related MCP servers

Seitrace Insights MCP Server