Skip to main content
Glama

dritan-mcp

MCP server for personal agents to use dritan-sdk for market data and swap execution, with local Solana wallet signing.

Requirements

  • Node.js 20+

  • solana-keygen available in PATH

  • Optional: Dritan API key (DRITAN_API_KEY) for market/swap tools.

  • For paid onboarding without an existing key, use x402 tools.

Related MCP server: Armor Crypto MCP

Setup

npm install
cp .env.example .env

Install As MCP (npx)

npx @dritan/mcp@latest

Codex example:

codex mcp add dritan npx \"@dritan/mcp@latest\"

Run

npm run dev
# or
npm run build && npm start

Tools

  • system_check_prereqs

  • auth_status

  • auth_set_api_key

  • auth_clear_api_key

  • wallet_create_local

  • wallet_get_address

  • wallet_get_balance

  • wallet_transfer_sol

  • x402_get_pricing

  • x402_create_api_key_quote

  • x402_create_api_key

  • dritan_health

  • market_get_snapshot

  • token_search

  • token_get_price

  • token_get_metadata

  • token_get_risk

  • token_get_first_buyers

  • token_get_aggregated

  • token_get_deployer_stats

  • token_get_ohlcv

  • token_get_ohlcv_chart

  • wallet_get_performance

  • wallet_get_performance_chart

  • wallet_get_token_performance

  • wallet_get_portfolio_chart

  • wallet_get_portfolio_chart_visual

  • wallet_get_summary

  • wallet_get_trade_history

  • wallet_get_holdings

  • wallet_get_holdings_chart

  • wallet_get_holdings_page

  • market_stream_sample

  • wallet_stream_sample

  • ths_health

  • ths_get_score

  • ths_get_score_tokens_get

  • ths_get_score_tokens_post

  • ths_get_top_wallets

  • swap_build

  • swap_sign_and_broadcast

  • swap_build_sign_and_broadcast

Notes

  • Wallets default to the current working directory (process.cwd()).

  • Private keys never leave local files; only public address/signature are returned.

  • swap_sign_and_broadcast signs locally, then broadcasts via Dritan.

  • auth_set_api_key activates a key for the running MCP process without restart and persists it to a local auth store.

  • auth_set_api_key and successful x402_create_api_key responses include a capability summary so agents can immediately guide users to next actions.

  • Agent onboarding without an active API key should use x402-first flow (wallet_create_local in current directory -> share wallet + backup file path -> user chooses SOL amount and funds agent wallet -> if no key exists use x402_create_api_key_quote -> wallet_transfer_sol -> x402_create_api_key).

  • Free key at https://dritan.dev is fallback only if the user declines funding or x402 cannot proceed.

  • x402_create_api_key auto-activates returned keys and persists them locally for restart recovery.

  • Default auth store path is .dritan-mcp/auth.json under current working directory; override with DRITAN_MCP_AUTH_FILE.

  • Use auth_clear_api_key to remove in-memory + persisted key state (and optionally clear process env key).

  • token_get_ohlcv_chart returns ready-to-send markdown image output (raw chart URL fields are intentionally omitted to force inline embedding).

  • token_get_ohlcv_chart supports chartType: "line-volume" | "candlestick" (default is candlestick).

  • token_get_ohlcv_chart defaults to maxPoints: 30; set higher maxPoints only when users explicitly ask for more history.

  • Wallet visual chart workflow:

  • wallet_get_holdings_chart for balance allocation (token distribution).

  • wallet_get_portfolio_chart_visual for portfolio equity curve.

  • wallet_get_performance_chart for PnL history/summary/token-level bars depending on available fields.

  • For all chart tools, agents should send the returned markdown field directly (no plain URL output).

  • ths_get_top_wallets returns a paginated leaderboard of THS-ranked wallets (page, limit) for smart-wallet discovery workflows.

  • Ticker workflow for chart requests: token_search -> extract mint -> token_get_ohlcv or token_get_ohlcv_chart.

  • If users ask for $WIF style symbols, always resolve mint with token_search first.

  • If Solana CLI is missing, run system_check_prereqs and follow returned install steps.

Available Tools

42 tools
auth_clear_api_keyA

Clear the active in-memory API key and delete the persisted auth file. Optionally clear DRITAN_API_KEY in this process env.

Inputs: clearEnv.

auth_set_api_keyA

Set the active Dritan API key for this running MCP process and persist it locally for restart recovery.

Inputs: apiKey (required).

auth_statusA

Show current API key status for this MCP session (active source, preview, and onboarding options).

Inputs: no named parameters.

dritan_healthB

Check data plane health endpoint via Dritan SDK.

Inputs: no named parameters.

market_get_snapshotC

Fetch token market snapshot via Dritan SDK (price/metadata/risk/first-buyers/aggregated).

Inputs: mint (required), mode.

market_stream_sampleB

Open a DEX websocket stream and collect events for a short duration.

Inputs: dex (required), durationMs, maxEvents.

swap_buildC

Build an unsigned swap transaction with Dritan.

Inputs: inputMint (required), outputMint (required), amount (required), walletPath, +6 more.

swap_build_sign_and_broadcastC

Convenience tool: build swap, sign locally with wallet, and broadcast in one call.

Inputs: walletPath (required), inputMint (required), outputMint (required), amount (required), +5 more.

swap_sign_and_broadcastA

Sign a base64 swap transaction with a local wallet and broadcast through Dritan.

Inputs: walletPath (required), transactionBase64 (required).

system_check_prereqsA

Check whether required local binaries are installed (currently solana-keygen) and return install commands.

Inputs: no named parameters.

ths_get_scoreC

Fetch THS score for a wallet.

Inputs: wallet (required), debug, breakdown.

ths_get_score_tokens_getC

Fetch THS score for selected token mints using GET.

Inputs: wallet (required), tokenMints (required), debug, breakdown.

ths_get_score_tokens_postC

Fetch THS score for selected token mints using POST.

Inputs: wallet (required), tokenMints (required), debug, breakdown.

ths_get_top_walletsB

Fetch paginated top wallets ranked by THS score.

Inputs: page, limit.

ths_healthB

Check Meteora THS service health.

Inputs: no named parameters.

token_get_aggregatedC

Fetch aggregated token data via Dritan (same as market_get_snapshot mode=aggregated).

Inputs: mint (required).

token_get_deployer_statsC

Fetch token deployer stats via Dritan.

Inputs: mint (required).

token_get_first_buyersC

Fetch first buyers via Dritan.

Inputs: mint (required).

token_get_metadataC

Fetch token metadata via Dritan.

Inputs: mint (required).

token_get_ohlcvC

Fetch OHLCV candles for a token and timeframe.

Inputs: mint (required), timeframe (required), timeTo.

token_get_ohlcv_chartA

Build embeddable chart markdown from token OHLCV candles so agents can render the actual chart inline in chat (resolve ticker with token_search first). Supports line-volume or candlestick charts.

Inputs: mint (required), timeframe (required), timeTo, chartType, +4 more.

token_get_priceC

Fetch token price via Dritan (same as market_get_snapshot mode=price).

Inputs: mint (required).

token_get_riskA

Fetch token risk via Dritan (same as market_get_snapshot mode=risk).

Inputs: mint (required).

wallet_create_localB

Create a local Solana wallet using solana-keygen and return path + public address.

Inputs: name, walletDir.

wallet_get_addressA

Get the public address for a local Solana wallet file.

Inputs: walletPath (required).

wallet_get_balanceA

Get SOL balance for a local wallet address from a Solana RPC endpoint.

Inputs: walletPath (required), rpcUrl.

wallet_get_holdingsD

Fetch wallet holdings via Dritan.

Inputs: wallet (required).

wallet_get_holdings_chartC

Build embeddable holdings allocation chart markdown from wallet holdings so agents can render token balance distribution inline.

Inputs: wallet (required), top, width, height.

wallet_get_holdings_pageC

Fetch paginated wallet holdings via Dritan.

Inputs: wallet (required), page (required).

wallet_get_performanceD

Fetch wallet performance via Dritan.

Inputs: wallet (required), showHistoricPnL, holdingCheck, hideDetails.

wallet_get_performance_chartB

Build embeddable wallet PnL chart markdown (history when available, otherwise summary/token PnL bars) for graphical performance views.

Inputs: wallet (required), showHistoricPnL, holdingCheck, hideDetails, +4 more.

wallet_get_portfolio_chartC

Fetch wallet portfolio chart series via Dritan.

Inputs: wallet (required), days.

wallet_get_portfolio_chart_visualB

Build embeddable line-chart markdown for wallet portfolio history so agents can render a graphical portfolio view inline.

Inputs: wallet (required), days, maxPoints, width, +1 more.

wallet_get_summaryC

Fetch basic wallet summary via Dritan.

Inputs: wallet (required).

wallet_get_token_performanceC

Fetch wallet performance for a specific token mint via Dritan.

Inputs: wallet (required), tokenMint (required).

wallet_get_trade_historyC

Fetch wallet trade history via Dritan.

Inputs: wallet (required), cursor.

wallet_stream_sampleC

Open the wallet websocket stream and collect events for selected wallets.

Inputs: wallets (required), durationMs, maxEvents.

wallet_transfer_solB

Send SOL from a local wallet to a destination wallet (used in x402 paid key flow).

Inputs: walletPath (required), toAddress (required), lamports, sol, +1 more.

x402_create_api_keyC

Claim a paid x402 API key using quoteId and payment transaction signature.

Inputs: quoteId (required), paymentTxSignature (required), payerWallet, name, +1 more.

x402_create_api_key_quoteA

Create an x402 payment quote for a time-limited API key (returns quoteId, receiverWallet, and exact SOL amount).

Inputs: durationMinutes (required), name, payerWallet, scopes.

x402_get_pricingB

Get x402 pricing and receiver wallet for paid time-limited API keys.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 42 tools

    Disambiguation2/5

    Several tools have overlapping purposes (e.g., market_get_snapshot vs token_get_aggregated, price, risk; ths_get_score_tokens_get vs post; wallet_get_holdings vs wallet_get_holdings_page). Multiple chart tools could be consolidated. This creates ambiguity for an agent.

    Naming Consistency4/5

    Tools mostly follow a domain_verb_noun pattern (e.g., auth_set_api_key, token_get_metadata). However, there are minor inconsistencies like ths_get_score_tokens_get vs ths_get_score_tokens_post where the verb order differs. Overall predictable.

    Tool Count3/5

    42 tools is on the high side, but they cover a broad domain (auth, market, swaps, tokens, wallets, x402). However, several near-duplicates inflate the count (e.g., chart tools, HTTP method variants). Could be streamlined to ~30 tools.

    Completeness4/5

    The tool surface covers key operations for the Dritan ecosystem: authentication, market data, token metadata, swaps, wallet management, THS scoring, and x402 payments. Minor gaps exist, such as no tool to list all tokens or manage swap orders beyond building, but core workflows are supported.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server enabling AI agents to interact with the Solana blockchain for DeFi operations like checking balances, transferring tokens, executing swaps, and fetching price data.
      21
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Non-custodial Solana swap & limit order engine for AI agents. 21 tools - swap, limit, trailing, TWAP, DCA, combo orders - across Raydium, PumpSwap, Orca, Meteora. Jito MEV-protected execution. Ed25519-verified server messages. Private key never leaves the process.
      21
      183 npm
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to read chain data, execute transactions, swap tokens, and manage wallets on Solana through 38 tools across 7 modules. Supports write operations with a private key and includes built-in prompts for common workflows.
      38
      1
      MIT