What can you do with this server?

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 data * finance_stock_screen — Screen and rank stocks by criteria such as industry, PE/PB ratio, market cap, and dividend yield * finance_market — Get market overviews including indices, sector rankings, fund rankings, valuation maps, and macro indicators * finance_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 recency * info_scrape — Scrape any webpage and return its content as clean markdown * info_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 coordinates * life_logistics — Track courier packages by tracking number with auto-detection of the carrier * life_ip — Look up geolocation info (country, city, timezone, ISP) for any IP address, or the caller's own IP

Which integrations are available for this server?

Provides real-time hot search rankings from Zhihu, enabling AI agents to access trending topics and discussions on the platform.

de en es ja ko ru zh

GroundAPI

by qingkongzhiqian

Overview Schema Related Servers Score Discussions

Python

Remote

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.

License: MIT MCP PyPI

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 600519

MCP 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
`symbol`	string	—	Stock code. Comma-separated for comparison (e.g. `"600519,000858"`)
`keyword`	string	—	Search by name (e.g. `"茅台"`)
`aspects`	string	`"overview"`	Data dimensions, comma-separated (see table below)
`days`	int	`60`	History range for kline/technical
`period`	string	`"d"`	K-line period: `5/15/30/60/d/w/m`

11 Available Aspects:

Aspect	Returns	Use When
`overview`	Quick snapshot: quote + profile brief + financial brief	"How's XXXX doing?"
`profile`	Full company info, concepts, index membership, capital structure	"What does this company do?"
`quote`	Latest closing price, PE/PB, limit up/down distance	"Current price?"
`kline`	K-line data (supports 5/15/30/60min, daily, weekly, monthly)	"Show me the chart"
`technical`	MACD, MA, BOLL, KDJ + signal detection (e.g. "DIF crosses above DEA")	"Technical analysis?"
`financial`	3 financial statements, quarterly P&L, cash flow, dividends, forecasts	"How are the financials?"
`holders`	Top 10 shareholders, float holders, count trend, fund holdings	"Who are the major shareholders?"
`management`	Executives, board directors, supervisors	"Who's the management?"
`events`	Dividends, share issuance, lock-up expiry, earnings calendar	"When's the next dividend?"
`summary`	Multi-dimensional factual aggregation (no opinions)	"Give me a full data summary"
`peers`	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 ETF

`finance_market` — Market Overview

Market-wide data: major indices, hot stocks, sector rotation, IPO calendar, anomaly signals.

Parameter	Type	Default	Description
`scope`	string	`"overview"`	Data scope, comma-separated
`sector`	string	—	Drill into a specific sector
`date`	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 calendar

`finance_screen` — Stock Screener

Multi-criteria screening with 20+ dimensions and preset filter combinations.

Parameter	Type	Description
`industry`	string	Industry filter (e.g. `"银行"`, `"半导体"`)
`concept`	string	Concept filter (e.g. `"AI"`, `"新能源"`)
`pe_max` / `pe_min`	float	PE ratio range
`pb_max`	float	Max PB ratio
`min_market_cap` / `max_market_cap`	float	Market cap range
`min_dividend_yield`	float	Min dividend yield (%)
`filter_preset`	string	`low_pe_high_div` · `small_cap_growth` · `large_cap_stable`
`sort_by`	string	Sort field (default: `change_pct`)

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 picks

`finance_search` — Universal Search

Search across 11,780+ securities: stocks, concepts, sectors, ETFs, indices.

Parameter	Type	Description
`keyword`	string	Search query
`type`	string	`all` · `stock` (6,104) · `concept` (2,222) · `sector` (1,466) · `etf` (1,377) · `index` (613)

finance_search(keyword="芯片", type="etf")        # Chip ETFs
finance_search(keyword="AI", type="concept")       # AI concept indices
finance_search(keyword="沪深300", type="index")    # CSI 300

`finance_gold_price` — Precious Metals

finance_gold_price()   # Gold, silver, platinum prices

Information (4 tools)

`info_search` — Web Search

Parameter	Type	Description
`query`	string	Search keywords
`count`	int	Number of results (1–50, default 10)
`recency`	string	`noLimit` · `oneDay` · `oneWeek` · `oneMonth` · `oneYear`

info_search(query="AI Agent trends 2026", count=20, recency="oneWeek")

`info_news` — News Headlines

Parameter	Type	Description
`category`	string	`finance` · `general` · `tech` · `sports` ...
`limit`	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 digest

Life Services (2 tools)

`life_weather` — Weather

Parameter	Type	Description
`city`	string	City name (e.g. `"Beijing"`)
`location`	string	Lat,lng (e.g. `"39.9,116.4"`)
`forecast`	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 date

REST API

Base URL: https://api.groundapi.net

All endpoints require X-API-Key header.

Endpoint	Description
`GET /v1/finance/stock`	Stock/index/ETF data
`GET /v1/finance/stock/screen`	Stock screening
`GET /v1/finance/market`	Market overview
`GET /v1/finance/search`	Securities search
`GET /v1/finance/gold-price`	Gold & precious metals
`GET /v1/info/search`	Web search
`GET /v1/info/news`	News headlines
`GET /v1/info/trending`	Trending topics
`GET /v1/info/bulletin`	Daily briefing
`GET /v1/life/weather`	Weather
`GET /v1/life/calendar`	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_KEY

Finance

# 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 prices

Information

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 briefing

Life 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 info

Agent Skills

Pre-built skills that combine GroundAPI tools into automated workflows. Install in Cursor, OpenClaw, or Smithery:

Skill	Description
Market Briefing	Generates daily A-share market summary — indices, sectors, hot stocks, anomalies
A-Share Analyst	Deep analysis with 11 data dimensions — outputs structured report with technicals and financials
Stock Screener	Natural language stock screening — "find undervalued bank stocks with high dividends"
Context Aware	Daily assistant — weather, calendar, news in one shot
Anomaly Tracker	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.py

Or connect to the hosted MCP endpoint (no deployment needed):

https://mcp.groundapi.net/mcp

Pricing

	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.

License

MIT — Skills, MCP server wrapper, and documentation only. GroundAPI is a commercial API service.

Install Server

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Resources

GitHub Repository

Need Help?

Related Servers

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/qingkongzhiqian/groundapi'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

GroundAPI

Table of Contents

Quick Start

Option 1: MCP (recommended for AI Agents)

Option 2: REST API

Option 3: CLI

MCP Tools Reference

Finance (5 tools)

`finance_stock` — Securities Data

`finance_market` — Market Overview

`finance_screen` — Stock Screener

`finance_search` — Universal Search

`finance_gold_price` — Precious Metals

Information (4 tools)

`info_search` — Web Search

`info_news` — News Headlines

`info_bulletin` — Daily Briefing

Life Services (2 tools)

`life_weather` — Weather

`life_calendar` — Calendar & Trading Days

REST API

CLI Reference

Install

Finance

Information

Life Services

Agent Skills

Self-hosted MCP Server

Pricing

Links

License

Maintenance

Resources

Latest Blog Posts

MCP directory API

Table of Contents

Quick Start

Option 1: MCP (recommended for AI Agents)

Option 2: REST API

Option 3: CLI

MCP Tools Reference

Finance (5 tools)

finance_stock — Securities Data

finance_market — Market Overview

finance_screen — Stock Screener

finance_search — Universal Search

finance_gold_price — Precious Metals

Information (4 tools)

info_search — Web Search

info_news — News Headlines

info_trending — Trending Topics

info_bulletin — Daily Briefing

Life Services (2 tools)

life_weather — Weather

life_calendar — Calendar & Trading Days

REST API

CLI Reference

Install

Finance

Information

Life Services

Agent Skills

Self-hosted MCP Server

Pricing

Links

License

Maintenance

Resources

Latest Blog Posts

MCP directory API

`finance_stock` — Securities Data

`finance_market` — Market Overview

`finance_screen` — Stock Screener

`finance_search` — Universal Search

`finance_gold_price` — Precious Metals

`info_search` — Web Search

`info_news` — News Headlines

`info_trending` — Trending Topics

`info_bulletin` — Daily Briefing

`life_weather` — Weather

`life_calendar` — Calendar & Trading Days