MCP 服务器

Clawy MCP Server

Pay-per-use API tools and LLM gateway for AI agents. 15 services (DART, Tabelog, Google Maps, Brave Search, Firecrawl, DeepL, ElevenLabs, and more) + smart LLM routing. No API keys needed, pay with USDC on Base.

README

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.)

Auth: Your wallet private key signs an EIP-191 message -> 24-hour session token (auto-refreshed)
Use: Call any tool through MCP — the server proxies to the gateway
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:

Create a wallet (e.g., via MetaMask or any EVM wallet)
Fund it with USDC on Base chain
Send USDC to 0x6a2f675f5f81909eecd1966a15c90877bc106858 to top up credits
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