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.