hodlodds-mcp — Claude Code MCP server: odds and setup
Give an agent local tools to discover markets and check crash odds for Solana tokens. Paid requests use x402 with USDC on Solana or Base.
claude mcp add --env HODLODDS_BASE_URL=<HODLODDS_BASE_URL> --env HODLODDS_NETWORK=<HODLODDS_NETWORK> --env HODLODDS_PAY_TO=<HODLODDS_PAY_TO> --env HODLODDS_KEYPAIR=<HODLODDS_KEYPAIR> --env HODLODDS_MAX_PRICE_USDC=<HODLODDS_MAX_PRICE_USDC> --transport stdio hodlodds-mcp -- uvx hodlodds-mcpWhat hodlodds-mcp does
hodlodds-mcp exposes local tools for market discovery and token risk queries. Its forecasts estimate the chance that a token’s price drops by at least 90% within the next hour. Coverage is for SOL-quoted pump.fun graduates. Free endpoints let the agent check API status, available markets, and coverage for a token.
Fresh risk answers and returned board entries cost USDC through x402. The server supports payment limits per call and per session. Paid requests require configuration for the chosen network, recipient address, key file, and maximum price. Without those payment settings, the agent cannot purchase a risk answer.
What it helps with
- check which markets and tokens the API covers
- find out whether a token has coverage
- request an estimate of a token’s crash odds
- retrieve board entries within chosen risk criteria
Example prompts for the agent
- Check the API status and list the available markets.
- Check coverage for token
<MINT>on Solana and pump.fun. - Get fresh crash odds for token
<MINT>.
How to install hodlodds-mcp
Platform CLI
claude mcp add --env HODLODDS_BASE_URL=<HODLODDS_BASE_URL> --env HODLODDS_NETWORK=<HODLODDS_NETWORK> --env HODLODDS_PAY_TO=<HODLODDS_PAY_TO> --env HODLODDS_KEYPAIR=<HODLODDS_KEYPAIR> --env HODLODDS_MAX_PRICE_USDC=<HODLODDS_MAX_PRICE_USDC> --transport stdio hodlodds-mcp -- uvx hodlodds-mcpReplace <…> with your own values. 1 more environment variable is in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from hodlodds-mcp <command>
Platform CLI
codex mcp add hodlodds-mcp --env HODLODDS_BASE_URL=<HODLODDS_BASE_URL> --env HODLODDS_NETWORK=<HODLODDS_NETWORK> --env HODLODDS_PAY_TO=<HODLODDS_PAY_TO> --env HODLODDS_KEYPAIR=<HODLODDS_KEYPAIR> --env HODLODDS_MAX_PRICE_USDC=<HODLODDS_MAX_PRICE_USDC> -- uvx hodlodds-mcpReplace <…> with your own values. 1 more environment variable is in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from hodlodds-mcp <command>
Config file
{
"mcpServers": {
"hodlodds-mcp": {
"command": "uvx",
"args": [
"hodlodds-mcp"
],
"env": {
"HODLODDS_BASE_URL": "<HODLODDS_BASE_URL>",
"HODLODDS_NETWORK": "<HODLODDS_NETWORK>",
"HODLODDS_PAY_TO": "<HODLODDS_PAY_TO>",
"HODLODDS_KEYPAIR": "<HODLODDS_KEYPAIR>",
"HODLODDS_MAX_PRICE_USDC": "<HODLODDS_MAX_PRICE_USDC>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from hodlodds-mcp <command>
Config file
{
"servers": {
"hodlodds-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"hodlodds-mcp"
],
"env": {
"HODLODDS_BASE_URL": "<HODLODDS_BASE_URL>",
"HODLODDS_NETWORK": "<HODLODDS_NETWORK>",
"HODLODDS_PAY_TO": "<HODLODDS_PAY_TO>",
"HODLODDS_KEYPAIR": "<HODLODDS_KEYPAIR>",
"HODLODDS_MAX_PRICE_USDC": "<HODLODDS_MAX_PRICE_USDC>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from hodlodds-mcp <command>
Platform CLI
gemini mcp add -e HODLODDS_BASE_URL=<HODLODDS_BASE_URL> -e HODLODDS_NETWORK=<HODLODDS_NETWORK> -e HODLODDS_PAY_TO=<HODLODDS_PAY_TO> -e HODLODDS_KEYPAIR=<HODLODDS_KEYPAIR> -e HODLODDS_MAX_PRICE_USDC=<HODLODDS_MAX_PRICE_USDC> hodlodds-mcp uvx hodlodds-mcpReplace <…> with your own values. 1 more environment variable is in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from hodlodds-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about hodlodds-mcp
How do I install hodlodds-mcp in Claude Code?
Run claude mcp add hodlodds-mcp -- uvx hodlodds-mcp. To configure payments, run `claude mcp add --env HODLODDS_BASE_URL=<HODLODDS_BASE_URL> --env HODLODDS_NETWORK=<HODLODDS_NETWORK> --env HODLODDS_PAY_TO=<HODLODDS_PAY_TO> --env HODLODDS_KEYPAIR=<HODLODDS_KEYPAIR> --env HODLODDS_MAX_PRICE_USDC=<HODLODDS_MAX_PRICE_USDC> --transport stdio hodlodds-mcp -- uvx hodlodds-mcp`.
What does hodlodds-mcp do?
It gives an agent local tools for market discovery and crash-odds queries for covered Solana tokens. The tools can also check API status and token coverage.
How are paid risk queries billed?
They use x402 payments in USDC on Solana or Base. Configure the network, key file, recipient address, and maximum price for paid requests.
