GroundAPI
GroundAPI provides a unified real-time data layer for AI agents, offering 10 tools across finance, information, and life services.
Finance Tools:
finance_stock— Query A-share stocks, indices, and ETFs by symbol or keyword; get real-time quotes, historical data, technical indicators (MA, MACD, RSI), and fundamental datafinance_stock_screen— Screen and rank stocks by criteria such as industry, PE/PB ratio, market cap, and dividend yieldfinance_market— Get market overviews including indices, sector rankings, fund rankings, valuation maps, and macro indicatorsfinance_fund— Search, get details, or rank mutual funds by performance metrics
Information Tools:
info_search— Search the web for titles, links, and snippets with filters for result count and recencyinfo_scrape— Scrape any webpage and return its content as clean markdowninfo_news— Fetch latest news headlines by category (finance, tech, sports, etc.)
Life Services Tools:
life_weather— Get current weather and optional 7-day forecasts by city name or coordinateslife_logistics— Track courier packages by tracking number with auto-detection of the carrierlife_ip— Look up geolocation info (country, city, timezone, ISP) for any IP address, or the caller's own IP
Provides real-time hot search rankings from Zhihu, enabling AI agents to access trending topics and discussions on the platform.
GroundAPI provides a unified data layer for AI Agents — 11 tools across finance, information, and life services. One API key, three access methods: REST API, MCP, and CLI.
Table of Contents
Related MCP server: Stock MCP
Quick Start
Get your API key at groundapi.net — 500 free calls/month, no credit card required.
Option 1: MCP (recommended for AI Agents)
Add to Claude Desktop, Cursor, Windsurf, or any MCP-compatible client:
{
"mcpServers": {
"groundapi": {
"url": "https://mcp.groundapi.net/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}Option 2: REST API
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.groundapi.net/v1/finance/stock?symbol=600519&aspects=overview"Option 3: CLI
pip install groundapi-cli
groundapi config set-key YOUR_API_KEY
groundapi stock --symbol 600519MCP Tools Reference
Finance (5 tools)
finance_stock — Securities Data
All-in-one query for A-share stocks, indices, and ETFs. Supports 11 data dimensions and multi-stock comparison.
Parameter | Type | Default | Description |
| string | — | Stock code. Comma-separated for comparison (e.g. |
| string | — | Search by name (e.g. |
| string |
| Data dimensions, comma-separated (see table below) |
| int |
| History range for kline/technical |
| string |
| K-line period: |
11 Available Aspects:
Aspect | Returns | Use When |
| Quick snapshot: quote + profile brief + financial brief | "How's XXXX doing?" |
| Full company info, concepts, index membership, capital structure | "What does this company do?" |
| Latest closing price, PE/PB, limit up/down distance | "Current price?" |
| K-line data (supports 5/15/30/60min, daily, weekly, monthly) | "Show me the chart" |
| MACD, MA, BOLL, KDJ + signal detection (e.g. "DIF crosses above DEA") | "Technical analysis?" |
| 3 financial statements, quarterly P&L, cash flow, dividends, forecasts | "How are the financials?" |
| Top 10 shareholders, float holders, count trend, fund holdings | "Who are the major shareholders?" |
| Executives, board directors, supervisors | "Who's the management?" |
| Dividends, share issuance, lock-up expiry, earnings calendar | "When's the next dividend?" |
| Multi-dimensional factual aggregation (no opinions) | "Give me a full data summary" |
| Same-industry comparison table with PE/PB/market cap ranking | "How does it rank in the sector?" |
# Quick overview
finance_stock(symbol="600519")
# Deep dive with multiple aspects
finance_stock(symbol="600519", aspects="quote,technical,financial")
# Search by name
finance_stock(keyword="平安")
# Compare multiple stocks
finance_stock(symbol="601398,601939,600036", aspects="quote")
# Index / ETF
finance_stock(symbol="000001.SH", aspects="kline,technical") # SSE Composite
finance_stock(symbol="510300", aspects="quote") # CSI 300 ETFfinance_market — Market Overview
Market-wide data: major indices, hot stocks, sector rotation, IPO calendar, anomaly signals.
Parameter | Type | Default | Description |
| string |
| Data scope, comma-separated |
| string | — | Drill into a specific sector |
| string | — | Date filter (YYYY-MM-DD) |
Scopes: overview (indices + sentiment) · hot (limit-up/down pools, streak breakdown) · sectors (concept & industry lists) · ipo (IPO calendar) · signals (anomaly detection)
finance_market() # Today's market
finance_market(scope="hot") # Limit-up/down stocks
finance_market(scope="sectors", sector="AI") # AI sector constituents
finance_market(scope="ipo") # IPO calendarfinance_screen — Stock Screener
Multi-criteria screening with 20+ dimensions and preset filter combinations.
Parameter | Type | Description |
| string | Industry filter (e.g. |
| string | Concept filter (e.g. |
| float | PE ratio range |
| float | Max PB ratio |
| float | Market cap range |
| float | Min dividend yield (%) |
| string |
|
| string | Sort field (default: |
finance_screen(industry="银行", pe_max=10) # Low-PE bank stocks
finance_screen(min_dividend_yield=3, sort_by="dividend_yield") # High dividend
finance_screen(concept="AI") # AI concept stocks
finance_screen(filter_preset="low_pe_high_div") # Preset: value picksfinance_search — Universal Search
Search across 11,780+ securities: stocks, concepts, sectors, ETFs, indices.
Parameter | Type | Description |
| string | Search query |
| string |
|
finance_search(keyword="芯片", type="etf") # Chip ETFs
finance_search(keyword="AI", type="concept") # AI concept indices
finance_search(keyword="沪深300", type="index") # CSI 300finance_gold_price — Precious Metals
finance_gold_price() # Gold, silver, platinum pricesInformation (4 tools)
info_search — Web Search
Parameter | Type | Description |
| string | Search keywords |
| int | Number of results (1–50, default 10) |
| string |
|
info_search(query="AI Agent trends 2026", count=20, recency="oneWeek")info_news — News Headlines
Parameter | Type | Description |
| string |
|
| int | Number of articles (1–50) |
info_news(category="finance", limit=10)
info_news(category="tech")info_trending — Trending Topics
Hot search rankings from Weibo, Douyin, Zhihu, and more.
info_trending()info_bulletin — Daily Briefing
info_bulletin() # Morning news digestLife Services (2 tools)
life_weather — Weather
Parameter | Type | Description |
| string | City name (e.g. |
| string | Lat,lng (e.g. |
| bool | Include 7-day forecast |
life_weather(city="北京", forecast=True)
life_weather(location="39.9,116.4")life_calendar — Calendar & Trading Days
life_calendar() # Today: lunar date, solar terms, holiday, trading day
life_calendar(date="2026-05-01") # Specific dateREST API
Base URL: https://api.groundapi.net
All endpoints require X-API-Key header.
Endpoint | Description |
| Stock/index/ETF data |
| Stock screening |
| Market overview |
| Securities search |
| Gold & precious metals |
| Web search |
| News headlines |
| Trending topics |
| Daily briefing |
| Weather |
| Calendar info |
# Stock overview
curl -H "X-API-Key: YOUR_KEY" \
"https://api.groundapi.net/v1/finance/stock?symbol=600519&aspects=overview"
# Multi-aspect deep dive
curl -H "X-API-Key: YOUR_KEY" \
"https://api.groundapi.net/v1/finance/stock?symbol=600519&aspects=quote,technical,financial"
# Market overview
curl -H "X-API-Key: YOUR_KEY" \
"https://api.groundapi.net/v1/finance/market?scope=overview"
# Stock screening
curl -H "X-API-Key: YOUR_KEY" \
"https://api.groundapi.net/v1/finance/stock/screen?industry=银行&pe_max=10"
# Web search
curl -H "X-API-Key: YOUR_KEY" \
"https://api.groundapi.net/v1/info/search?q=AI+Agent&count=10"
# Weather
curl -H "X-API-Key: YOUR_KEY" \
"https://api.groundapi.net/v1/life/weather?city=北京&forecast=true"Full API documentation: docs.groundapi.net
CLI Reference
Install
pip install groundapi-cli
groundapi config set-key YOUR_API_KEYFinance
# Stock quotes
groundapi stock --symbol 600519 # Latest quote
groundapi stock --keyword 贵州茅台 # Search by name
groundapi stock --symbol 600519 --date 2024-12-31 # Specific date
groundapi stock --symbol 600519 --days 30 # Last 30 days
groundapi stock --symbol 600519 --days 30 --include technicals # With technicals
# Screening
groundapi screen # Default ranking
groundapi screen --industry 白酒 --pe-max 30 # Industry + PE filter
groundapi screen --sort-by total_market_cap --limit 10 # Top 10 by market cap
# Market overview
groundapi market # Indices + macro
groundapi market --include sectors,valuation # With sectors + valuation
groundapi market --sector 半导体 --type industry # Sector drill-down
# Finance search
groundapi fsearch 芯片 # Search securities
groundapi fsearch AI --type concept # AI concept indices
# Gold price
groundapi gold # Precious metals pricesInformation
groundapi search "AI Agent" # Web search
groundapi search "AI Agent" --count 20 --recency oneWeek # With filters
groundapi news # Finance news
groundapi news --category tech --limit 10 # Tech news
groundapi trending # Trending topics
groundapi bulletin # Daily briefingLife Services
groundapi weather --city 北京 # Current weather
groundapi weather --city 北京 --forecast # 7-day forecast
groundapi weather --location 39.9,116.4 # By coordinates
groundapi calendar # Today's calendar infoAgent Skills
Pre-built skills that combine GroundAPI tools into automated workflows. Install in Cursor, OpenClaw, or Smithery:
Skill | Description |
Generates daily A-share market summary — indices, sectors, hot stocks, anomalies | |
Deep analysis with 11 data dimensions — outputs structured report with technicals and financials | |
Natural language stock screening — "find undervalued bank stocks with high dividends" | |
Daily assistant — weather, calendar, news in one shot | |
Market anomaly detection — unusual volume, price gaps, limit-up streaks |
Self-hosted MCP Server
Run the MCP server locally (stdio transport for local AI clients):
pip install -r requirements.txt
python mcp_server.pyOr connect to the hosted MCP endpoint (no deployment needed):
https://mcp.groundapi.net/mcpPricing
Free | Paid | |
Calls | 500/month | Pay-as-you-go |
Rate Limit | 60/min | 300/min |
Payment | — | Alipay / WeChat Pay / Credit Card |
Get your API key at groundapi.net.
Links
Website: groundapi.net
API Docs: docs.groundapi.net
MCP Endpoint:
https://mcp.groundapi.net/mcpCLI on PyPI: groundapi-cli
mcp.so: GroundAPI on mcp.so
License
MIT — Skills, MCP server wrapper, and documentation only. GroundAPI is a commercial API service.
Available Tools
10 toolsfinance_fundA
Query fund data: search, detail, or ranking.
Search: finance_fund(keyword="沪深300")
Detail: finance_fund(code="110011")
Ranking: finance_fund(sort_by="return_1y", limit=20)
Inputs: code, limit, order, keyword, +2 more. Returns: object
finance_marketA
Get market data. Supports multiple modes:
Market overview: finance_market() — indices, breadth, volume, top sectors, macro
With sectors: finance_market(include="sectors") — add sector ranking
With funds: finance_market(include="funds") — add fund ranking
With valuation: finance_market(include="valuation") — add industry valuation map
With macro: finance_market(include="macro") — add macro indicators
All extras: finance_market(include="sectors,funds,valuation,macro")
Sector detail: finance_market(sector="半导体") — specific sector with constituents
Inputs: date, type, limit, sector, +2 more. Returns: object
finance_stockA
Query A-share stock data. Supports multiple modes:
Search: finance_stock(keyword="茅台") — find stocks by name or code
Latest quote: finance_stock(symbol="600519") — current price, PE, PB, dividend yield
Specific date: finance_stock(symbol="600519", date="2026-03-28")
History: finance_stock(symbol="600519", days=60) — last N trading days
With technicals: finance_stock(symbol="600519", days=60, include="technicals")
With fundamentals: finance_stock(symbol="600519", include="fundamental") Either keyword or symbol is required.
Inputs: date, days, limit, symbol, +3 more. Returns: object
finance_stock_screenA
Screen stocks by criteria or get top/bottom rankings.
Ranking: finance_stock_screen(sort_by="change_pct", limit=10) — today's top gainers
Filter: finance_stock_screen(industry="半导体", pe_max=30) — semiconductor stocks with PE < 30 All filter params are optional. With no filters, returns a simple ranking.
Inputs: limit, order, pb_max, pe_max, +6 more. Returns: object
info_newsA
Get latest news headlines. category: finance/general/tech/sports/... (default: finance). limit: number of articles (1-50).
Inputs: limit, category. Returns: object
info_scrapeC
Read a webpage and return its content as markdown. url: the webpage URL to scrape.
Inputs: url (required). Returns: object
info_searchA
Search the web. Returns titles, links, and snippets. query: search keywords. count: number of results (1-50). recency: oneDay/oneWeek/oneMonth/oneYear/noLimit.
Inputs: query (required), count, recency. Returns: object
life_ipA
Get IP geolocation info. address: IP address (defaults to caller IP if omitted).
Inputs: address. Returns: object
life_logisticsA
Track a courier package. number: tracking number. company: courier company code (auto-detected if omitted).
Inputs: number (required), company. Returns: object
life_weatherA
Get weather data: current conditions and optional 7-day forecast. city: city name (e.g. '北京'). location: lat,lng. forecast: include 7-day forecast.
Inputs: city, forecast, location. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Every tool targets a distinct domain: fund, market, stock, info retrieval, and life utilities. No overlap in functionality.
All tools use a consistent 'domain_specific' lowercase underscore pattern, e.g., finance_fund, info_news, life_weather.
10 tools is well-scoped for a general-purpose assistant covering finance, info, and life domains. Each tool earns its place.
Finance tools cover fund, market, stock, and screening comprehensively. Info tools cover news, web scraping, and search. Life tools cover IP, logistics, weather. No obvious gaps.
Maintenance
Related MCP Connectors
Real-time data API for AI Agents: stocks, weather, forex, logistics, search, scrape, news, IP.
China A-share market data for research, backtesting and AI agents via MCP.
China A-share data for AI agents: 57 read-only tools plus 6 tools for your own watchlist.
660+ data tools for agents: TikTok, Douyin, Instagram, YouTube, X, weather, GitHub. Pay per call.
Related MCP Servers
- FlicenseNot gradedqualityAmaintenanceEnables AI agents and backend services to retrieve and analyze A-share, US equity, ETF, index, and crypto data, including technical indicators, fundamentals, money flow, filings, and news through MCP tools and HTTP APIs.-
- FlicenseNot gradedqualityAmaintenanceEnables AI agents and applications to access and analyze A-share, US equity, ETF, index, and crypto market data, including technical indicators, fundamentals, news, filings, money flow, and exportable CSV/JSON datasets through MCP tools and HTTP APIs.-
- FlicenseNot gradedqualityAmaintenanceEnables AI agents and HTTP clients to access standardized financial market data, technical indicators, fundamentals, news, money-flow, and filings across A-shares, US equities, ETFs, indices, and crypto, with MCP tools and CSV/JSON exports for code workflows.-
- FlicenseNot gradedqualityAmaintenanceEnables AI agents and backends to retrieve and analyze financial market data — A-shares, US equities, ETFs, indices, and crypto — through MCP tools or an HTTP API. It provides quotes and K-lines, technical indicators, fundamentals, money flow, filings, and news search, with CSV/JSON export for code-execution workflows.-