# ground-api

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add qingkongzhiqian/ground-api

# Browse available tools
npx -y @smithery/cli@latest tool list qingkongzhiqian/ground-api

# Get full schema for a tool
npx -y @smithery/cli@latest tool get qingkongzhiqian/ground-api finance_stock

# Call a tool
npx -y @smithery/cli@latest tool call qingkongzhiqian/ground-api finance_stock '{}'
```

## Direct MCP Connection

Endpoint: `https://ground-api--qingkongzhiqian.run.tools`

**Required config:**
- `apiKey` (query) — Your GroundAPI API Key (starts with sk_gapi_)

## Tools (10)

- `finance_stock` — Query A-share stock data. Supports multiple modes:
- `finance_stock_screen` — Screen stocks by criteria or get top/bottom rankings.
- `finance_market` — Get market data. Supports multiple modes:
- `finance_fund` — Query fund data: search, detail, or ranking.
- `info_search` — Search the web. Returns titles, links, and snippets.
- `info_scrape` — Read a webpage and return its content as markdown.
- `info_news` — Get latest news headlines.
- `life_weather` — Get weather data: current conditions and optional 7-day forecast.
- `life_logistics` — Track a courier package.
- `life_ip` — Get IP geolocation info.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get qingkongzhiqian/ground-api <tool-name>
```