clawy-mcp-server

v0.2.0

Published

4 days ago

Pay-per-use MCP server for AI agents — 18 API tools + smart LLM routing. No API keys needed, pay with USDC on Base.

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

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

License

MIT