# GroundAPI

GroundAPI — a remote MCP server with 13 tools: A-share quotes, weather, FX rates, parcel tracking, web search and IP lookup, all behind one key.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 154 installs
- Author: groundapi
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/groundapi/groundapi
- Updated: 2026-03-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/groundapi

## What it does

Nothing runs on your machine. GroundAPI is an HTTP MCP endpoint at `https://groundapi--groundapi.run.tools`, and the agent talks to it directly. Thirteen tools sit behind it. Six cover mainland A-share equities: a latest quote, a paged list filtered by exchange, search by ticker or name, a single day's bar, daily K-line history over a date range, and a gainers/losers ranking sortable by change percent, volume or turnover.

The other seven handle city weather, a pair of ISO 4217 currencies, courier tracking, web search, page-to-markdown extraction, a news feed by category, and IP geolocation with country, city and ISP.

Every call carries an `api_key` argument and fails without it. The free tier covers 500 calls per month, and web search eats that faster than quotes do. Some couriers also want the last four digits of the recipient's phone number before tracking works.

## Requirements
- Remote server: `https://groundapi--groundapi.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http groundapi https://groundapi--groundapi.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add groundapi --url https://groundapi--groundapi.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "groundapi": {
            "url": "https://groundapi--groundapi.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "groundapi": {
            "type": "http",
            "url": "https://groundapi--groundapi.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http groundapi https://groundapi--groundapi.run.tools
```

## When to use it
- pull a live A-share quote into an agent answer
- walk through daily candles for a date range
- track a parcel without leaving the chat
- turn a page into markdown the agent can read
- find out where an IP address is registered

## Example prompts
- Get me the latest quote for 600519.
- Track this order's parcel and figure out the carrier yourself.
- Scrape the pricing page and hand it back as markdown.

## Similar
- [market-environment-analysis](https://affpapa.org/en/nevibecode/skills/market-environment-analysis.md) — skill · 4300 installs
- [twelvedata](https://affpapa.org/en/nevibecode/skills/twelvedata.md) — skill · 7800 installs
- [Finance MCP — Stocks, Crypto, FX, Portfolio Math](https://affpapa.org/en/nevibecode/mcp/finance-mcp-stocks-crypto-fx-portfolio-math.md) — MCP server · 6135 installs
- [TickDB Market Data](https://affpapa.org/en/nevibecode/mcp/tickdb-market-data.md) — MCP server · ★ 938 repo stars
- [Kandle](https://affpapa.org/en/nevibecode/mcp/kandle.md) — MCP server · ★ 9 repo stars
- [technical-analyst](https://affpapa.org/en/nevibecode/skills/technical-analyst.md) — skill · 4500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
