Clawy MCP Server

Pay-per-use API tools and LLM gateway for AI agents. No API keys needed — authenticate with an Ethereum wallet and pay with USDC on Base.

18 API services + smart LLM routing, accessible via Model Context Protocol (MCP).

Quick Start

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "clawy": {
      "command": "npx",
      "args": ["-y", "clawy-mcp-server"],
      "env": {
        "CLAWY_WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Cursor / Windsurf

Same config in your .cursor/mcp.json or equivalent.

Top Up Credits

Send USDC on Base chain to 0x6a2f675f5f81909eecd1966a15c90877bc106858 (minimum $1). Credits are applied automatically.

---

Available Tools

Financial Data

Tool	Description	Cost
dart_disclosure	Search Korean corporate filings from DART (FSS electronic disclosure)	$0.001
dart_financial	Korean company financial statements (income, balance sheet, cash flow)	$0.001
fmp_quote	Real-time & historical stock quotes (US + global markets)	$0.0012
fmp_financial	Company financial statements via Financial Modeling Prep	$0.0012

Search & Web Scraping

Tool	Description	Cost
brave_search	Privacy-focused web search with structured results and snippets	$0.006
firecrawl_scrape	Scrape any URL — handles JS rendering, returns clean markdown	$0.012
firecrawl_crawl	Crawl websites starting from a URL (cost per page)	$0.012/page
firecrawl_map	Discover all URLs on a site without extracting content	$0.012

Maps & Navigation

Tool	Description	Cost
google_maps_places	Search places, restaurants, landmarks via Google Maps	$0.0036
google_maps_geocode	Address <-> coordinates conversion	$0.006
google_maps_directions	Driving, walking, transit directions between points	$0.006
kakao_maps_search	Korean local search — best for Korean addresses and businesses	$0.001
tmap_route	Korean driving routes with real-time traffic, ETA, toll fees	$0.0012
tmap_poi	Korean POI search with detailed address info	$0.001

Travel

Tool	Description	Cost
hotels_search	Search 2M+ hotels worldwide via Jinko	$0.003
hotels_details	Full hotel details, room options, and rates	$0.0015
hotels_find_place	Convert location name to coordinates for hotel search	$0.0005
airbnb_search	Search Airbnb listings by location, dates, guests, and price	$0.003
airbnb_details	Full listing details, amenities, and house rules	$0.0015
flights_search	Search flights by origin, destination, and dates	$0.005
flights_calendar	View cheapest flights by month for a route	$0.003
flights_discover	Discover popular routes and deals from an origin	$0.003

Food & Dining

Tool	Description	Cost
tabelog_search	Search Japanese restaurants on Tabelog — ratings, reviews, cuisine	$0.0012
michelin_search	Search Michelin Guide restaurants (Japan, Korea, USA) by city, cuisine, or award	$0.0012

AI Generation

Tool	Description	Cost
gemini_image	Generate an image from a text prompt (Google Gemini)	$0.05
gemini_edit	Edit an existing image with a text prompt	$0.05
gemini_video	Start async video generation (Veo 3.1 Fast)	$0.50
gemini_video_status	Check video generation status	Free
elevenlabs_tts	AI text-to-speech synthesis (multiple voices & languages)	$0.015
elevenlabs_voices	List available voices with IDs and language info	Free

Sports

Tool	Description	Cost
golf_search	Search golf courses by name or region (Korea focus)	$0.0012
golf_course	Detailed golf course info — holes, par, green fees	$0.001

Government & Legal

Tool	Description	Cost
court_auction_search	Search Korean court auction property listings	$0.001
court_auction_detail	Detailed auction case info — appraisal, bids, documents	$0.001
data_go_kr_query	Korean government open data (real estate, weather, transport)	$0.001

LLM Gateway

Tool	Description	Cost
llm_chat	Smart-routed LLM — auto-selects Claude, GPT, or Kimi based on task complexity	$0.50/call

No API keys needed for any LLM provider. The smart router analyzes your request and picks the optimal model.

---

How It Works

Your AI Agent (Claude, Cursor, etc.)
    | MCP protocol (stdio)
clawy-mcp-server (this package)
    | HTTPS (Bearer token)
x402.clawy.pro (API Gateway)
    |
Upstream APIs (DART, Google Maps, Jinko Hotels, etc.)

1. Auth: Your wallet private key signs an EIP-191 message -> 24-hour session token (auto-refreshed)
2. Use: Call any tool through MCP — the server proxies to the gateway
3. Pay: Credits deducted per call (microcent precision). Top up by sending USDC on Base.

Wallet Setup

Use a dedicated wallet for this service. We recommend creating a new wallet specifically for API credits:

1. Create a wallet (e.g., via MetaMask or any EVM wallet)
2. Fund it with USDC on Base chain
3. Send USDC to 0x6a2f675f5f81909eecd1966a15c90877bc106858 to top up credits
4. Use the wallet's private key in CLAWY_WALLET_PRIVATE_KEY

Check Balance

Use the clawy_balance tool to check your remaining credits at any time.

---

Configuration

Environment Variable	Required	Description
CLAWY_WALLET_PRIVATE_KEY	Yes	Ethereum wallet private key (hex, with 0x prefix)
CLAWY_GATEWAY_URL	No	Gateway URL (default: https://x402.clawy.pro)

---

Use Cases

• Korean stock research: DART filings + FMP quotes + Brave search for news
• Japan restaurant planning: Tabelog + Michelin Guide + Google Maps directions
• Travel planning: Flight search + Hotels/Airbnb + Google Maps
• Korean real estate: Court auction listings + Kakao Maps for location
• Content creation: Gemini image/video generation + ElevenLabs TTS
• General AI agents: Smart LLM routing without managing API keys

---

Pricing

All prices include a 20% platform margin. Credits are in USDC (1 USDC = $1).

• Minimum top-up: $1 USDC
• Credits persist until used (no expiry)
• Microcent precision billing — you only pay for what you use

---

x402 Protocol

This server uses the x402 payment protocol for trustless, wallet-based API access:

• Identity: Your Ethereum wallet address = your account
• Auth: EIP-191 signature verification (no passwords, no signup)
• Payment: USDC on Base chain (low fees, fast confirmation)
• Billing: Per-call microcent deduction from prepaid credit balance

---

Links

• Gateway: x402.clawy.pro
• Platform: clawy.pro
• x402 Protocol: x402.org

License

MIT