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.

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.