# hodlodds-mcp

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: hodlodds
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hodlodds/hodlodds-sdk
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/hodlodds-mcp

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `HODLODDS_BASE_URL`, `HODLODDS_NETWORK`, `HODLODDS_PAY_TO`, `HODLODDS_KEYPAIR`, `HODLODDS_MAX_PRICE_USDC`, `HODLODDS_SESSION_BUDGET_USDC` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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
```
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>

### Codex

**Platform CLI**
```bash
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-mcp
```
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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
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>

## When to use it
- 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
- 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>`.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md