Skip to main content
Glama

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

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.

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

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)

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

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.

Available Tools

10 tools
finance_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

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

    A3.9/5.0

    Scored across 10 tools

    Disambiguation5/5

    Every tool targets a distinct domain: fund, market, stock, info retrieval, and life utilities. No overlap in functionality.

    Naming Consistency5/5

    All tools use a consistent 'domain_specific' lowercase underscore pattern, e.g., finance_fund, info_news, life_weather.

    Tool Count5/5

    10 tools is well-scoped for a general-purpose assistant covering finance, info, and life domains. Each tool earns its place.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -

    Appeared in Searches