Agent Integration Guide

Overview

GroundAPI provides native MCP (Model Context Protocol) support, allowing AI Agents to directly call 10 tools for finance, information, and life services data — no code required.

Supported AI clients:

Claude Desktop — Anthropic's official desktop client
Cursor — AI code editor
Windsurf / Cline / Continue — Other IDE plugins with MCP support
Custom Agents — Any application that supports the MCP protocol

Option 1: Remote MCP (Recommended)

No installation needed — connect directly to GroundAPI's remote MCP Server.

Claude Desktop

Edit the configuration file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "groundapi": {
      "url": "https://mcp.groundapi.net/mcp",
      "env": {
        "GROUNDAPI_API_KEY": "Your API Key"
      }
    }
  }
}

Cursor

Add in Cursor Settings → MCP:

{
  "mcpServers": {
    "groundapi": {
      "url": "https://mcp.groundapi.net/mcp",
      "env": {
        "GROUNDAPI_API_KEY": "Your API Key"
      }
    }
  }
}

Other MCP Clients

You only need the endpoint URL and API Key:

Endpoint: https://mcp.groundapi.net/mcp
Header: X-API-Key: Your API Key

Option 2: Local MCP (stdio Mode)

Suitable for offline usage or custom configuration scenarios.

Installation

pip install groundapi-cli

Configuration

Claude Desktop / Cursor configuration:

{
  "mcpServers": {
    "groundapi": {
      "command": "python",
      "args": ["-m", "mcp.server"],
      "env": {
        "GROUNDAPI_API_KEY": "Your API Key",
        "GROUNDAPI_BASE_URL": "https://api.groundapi.net"
      }
    }
  }
}

Available Tools

After setup, the Agent can use the following 10 tools:

Finance

Tool	Function	Example Prompt
`finance_stock`	Stock search/quotes/history/technicals	"What's the current price of Kweichow Moutai?"
`finance_stock_screen`	Stock screening/ranking	"Find semiconductor stocks with PE < 20"
`finance_market`	Market overview/sectors/funds/macro	"How's the market today?"
`finance_fund`	Fund search/ranking/details	"Best performing funds this year"

Information

Tool	Function	Example Prompt
`info_search`	Web search	"Search for the latest AI Agent frameworks"
`info_scrape`	Web scraping	"What does this webpage say?"
`info_news`	Trending news	"Any financial news today?"

Life Services

Tool	Function	Example Prompt
`life_weather`	Weather/7-day forecast	"What's the weather in Beijing?"
`life_logistics`	Package tracking	"Track SF Express SF1234567890"
`life_ip`	IP geolocation	"Where is 8.8.8.8 located?"

Multi-Tool Composition Examples

AI Agents can automatically combine multiple tools:

"Check Kweichow Moutai's price and recent news"

Agent automatically calls finance_stock for real-time quotes → info_search for related news.

"Find semiconductor stocks with PE < 15 and check the market trend"

Agent will:

Call finance_stock_screen to filter target stocks
Call finance_market to get market and sector data

FAQ

Can't connect to MCP Server?

Verify your API Key is correct (check in the Dashboard)
Confirm network access to mcp.groundapi.net
Restart Claude Desktop / Cursor

Tool calls returning errors?

Check the returned error.code:

INVALID_API_KEY — Invalid API Key, please verify
RATE_LIMIT_EXCEEDED — Too many requests, wait and try again
INVALID_PARAMS — Invalid parameter format, check your input
DATA_SOURCE_TIMEOUT — Upstream data source timed out, retry later

Is the free quota enough?

500 free calls per month, covering all 10 tools. Usage beyond the free quota is billed per call — see Pricing for details.