deepsearch-x402-mcp

MCP server for DeepSearch Korean Stock Intelligence API.

Pay-per-query via x402 micropayments — USDC on Base Mainnet. No API key needed.

Setup

1. Get a wallet with USDC

You need an EVM wallet with USDC on Base Mainnet.

• Buy USDC on Coinbase and send to Base
• Or bridge from Ethereum via bridge.base.org

2. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "deepsearch-stocks": {
      "command": "npx",
      "args": ["deepsearch-x402-mcp"],
      "env": {
        "MCP_WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Restart Claude Desktop. You should see 13 tools available.

3. Try it

Ask Claude:

• "What is Samsung Electronics' current PER and ROE?"
• "Show me SK Hynix stock performance over the last year"
• "Analyze the investment risks for NAVER (035420)"

Tools & Pricing

| Tool | Description | Cost | |------|-------------|------| | get_company | Fundamentals: market cap, PER, PBR, ROE, financials | $0.01 | | get_financials | Latest quarterly financial statements | $0.01 | | get_dividend | Dividend schedule and amounts | $0.01 | | get_news | Recent 30-day news with sentiment | $0.01 | | get_stock_1m | 1-month daily price history | $0.01 | | get_stock_3m | 3-month daily price history | $0.02 | | get_financials_2y | 2-year quarterly financials | $0.02 | | get_stock_1y | 1-year daily price history | $0.03 | | get_financials_5y | 5-year quarterly financials | $0.03 | | get_issue | News-driven issue analysis | $0.05 | | get_risk | Investment risk assessment | $0.05 | | get_stock_3y | 3-year daily price history | $0.05 | | get_financials_all | All available quarterly data | $0.05 |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | MCP_WALLET_PRIVATE_KEY | ✅ | EVM private key (0x...) — wallet must hold USDC on Base Mainnet | | RESOURCE_SERVER_URL | ❌ | Override API server URL (default: https://x402.deepsearch.com) |

Ticker Format

Korean stocks use 6-digit KRX codes:

• 005930 — Samsung Electronics
• 000660 — SK Hynix
• 035420 — NAVER
• 005380 — Hyundai Motor
• 051910 — LG Chem

Links

• API Server
• x402scan listing
• x402 Protocol