deepsearch-x402-mcp

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