kaito-mcp-server

MCP proxy for Kaito AI crypto market intelligence API. Provides crypto market intelligence tools, reference resources, and prompt templates for sentiment analysis, mindshare tracking, social intelligence, and more.

Getting Started

All configurations require a Kaito API key. Set it as the KAITO_API_KEY environment variable.

Option A: Direct HTTP (recommended)

For MCP clients that support remote HTTP servers (Claude.ai, Claude Desktop, Claude Code, etc.):

{
  "mcpServers": {
    "kaito": {
      "type": "http",
      "url": "https://bff.kaito.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

No local installation required.

Option B: npx (stdio proxy)

For MCP clients that only support local stdio servers:

{
  "mcpServers": {
    "kaito": {
      "command": "npx",
      "args": ["-y", "kaito-mcp-server@latest"],
      "env": {
        "KAITO_API_KEY": "your-api-key"
      }
    }
  }
}

This runs a thin local proxy that forwards all requests to the Kaito API over HTTP.

Client-specific setup

Claude.ai (web)

Use Option A — add it as a remote MCP connector in Claude settings.

Claude Desktop (one-click)

Download the latest kaito-mcp-server.mcpb and open it — Claude Desktop will handle the rest.

Note: MCPB installs a pinned version and does not auto-update. To get the latest version, re-download the .mcpb from the latest release — or switch to the standard configuration which uses @latest to always pull the newest version.

Claude Desktop (manual)

Add Option A or Option B to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code

claude mcp add kaito -e KAITO_API_KEY=your-api-key -- npx -y kaito-mcp-server@latest

VS Code

Add the following to your User Settings (JSON) or .vscode/settings.json:

{
  "mcp": {
    "servers": {
      "kaito": {
        "command": "npx",
        "args": ["-y", "kaito-mcp-server@latest"],
        "env": {
          "KAITO_API_KEY": "your-api-key"
        }
      }
    }
  }
}

Cursor

Go to Cursor Settings → MCP → Add new MCP Server, and paste Option B.

Other MCP Clients

For any MCP-compatible client, the server can be started with:

KAITO_API_KEY=your-api-key npx -y kaito-mcp-server@latest

The transport is stdio. Use this command in your client's MCP server configuration.

Environment Variables

| Variable | Required | Default | Description | |---|---|---|---| | KAITO_API_KEY | Yes | — | Your Kaito API key | | KAITO_MCP_URL | No | https://bff.kaito.ai/api/mcp | Override the remote MCP endpoint (e.g., for staging) |

Tools

Reference

| Tool | Description | |------|-------------| | kaito_entities | List or search supported Kaito token identifiers by project name, token value, symbol, or CoinGecko slug | | kaito_narratives | List or search supported Kaito narrative IDs by narrative code or display name |

Search & Discovery

| Tool | Description | |------|-------------| | kaito_search | Default natural-language Kaito search for most user requests across Twitter, News, Research, and Podcast content | | kaito_feeds | Use this when you want the top ranked content feed for the whole market or scoped to a single resolved token, optionally within a time window. | | kaito_advanced_search | Power-user structured Kaito search with explicit control over tokens, usernames, sources, time filters, sorting, language, and thresholds |

Sentiment, Mindshare & Engagement

| Tool | Description | |------|-------------| | kaito_tweet_engagement_info | Detailed engagement metrics for a specific tweet, including likes, retweets, replies, views, and smart engagement count | | kaito_sentiment_entity | Daily sentiment time series for a token, including volume-weighted bullish and bearish scores plus notable events | | kaito_engagement | Daily engagement metrics for a token or keyword, including total and smart/KOL engagement | | kaito_mentions | Daily mention counts for a token or keyword across Twitter, News, Podcast, and Research | | kaito_mindshare_entity | Daily mindshare time series for a token, showing its share of crypto Twitter conversation | | kaito_mindshare_entity_arena | Project rankings by mindshare score, with optional category and time window filters | | kaito_mindshare_entity_delta | Top gainers and losers by mindshare change over a selected time window | | kaito_mindshare_narrative | Daily mindshare time series for a crypto narrative |

Account & KOL Analytics

| Tool | Description | |------|-------------| | kaito_smart_following_market | Market-level signal showing which accounts smart followers have recently followed | | kaito_smart_followers | Smart follower data for a Twitter user, including total smart follower count or gained followers for a specific date | | kaito_smart_following | Latest smart accounts followed by a Twitter user in reverse chronological order | | kaito_mindshare_entity_by_account | Top KOLs ranked by mindshare for a given token | | kaito_twitter_user_metadata | Twitter user profile metadata by user ID, including name, username, bio, follower stats, and account classification |

Events & Catalysts

| Tool | Description | |------|-------------| | kaito_events | Upcoming catalyst events for a token, with filtering by event type, source, and date range |

Resources

| Resource | URI | Description | |----------|-----|-------------| | Tokens | kaito://tokens | All supported token values, symbols, and project names (no auth required) | | Narratives | kaito://narratives | All supported narrative IDs (no auth required) |

Prompt Templates

| Prompt | Description | |--------|-------------| | analyze_token | Deep-dive on a single token: top discussions via search, sentiment, mindshare trends, and upcoming events | | market_roundup | Priority-ranked briefing of top stories with smart account signals, mindshare movers, and catalysts | | discover_trending | Trending discovery: mindshare arena rankings, delta movers, smart account signals, narrative shifts, and deep-dive search per top gainer | | social_listening | Full social analysis: key discussions, sentiment, mentions, engagement, KOL mindshare, smart followers, and optional competitor comparison | | watchlist_portfolio | Monitor developments, upcoming catalysts, and key narratives across a set of tokens with mindshare, sentiment, and events |

Development

git clone https://github.com/MetaSearch-IO/kaito-mcp-server.git
cd kaito-mcp-server
npm install
npm run build

Testing

Integration tests hit the real Kaito API via the proxy:

KAITO_API_KEY=your-key npm test

Tests are skipped if KAITO_API_KEY is not set.

MCP Inspector

KAITO_API_KEY=your-key npx @modelcontextprotocol/inspector node build/index.js

License

MIT