Ground MCP Server

Evidence-grounded context for AI agents.

Installation

# Use with npx (no installation required)
npx @raptrx/ground-mcp

# Or install globally
npm install -g @raptrx/ground-mcp

Usage

With Claude Desktop (Local)

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "ground": {
      "command": "npx",
      "args": ["@raptrx/ground-mcp", "--api-url", "http://localhost:8001"]
    }
  }
}

With Azure Deployment (Production)

For Ground deployed on Azure Container Apps:

{
  "mcpServers": {
    "ground": {
      "command": "npx",
      "args": [
        "@raptrx/ground-mcp",
        "--api-url", "https://ground-api.azurewebsites.net",
        "--api-key", "your-api-key"
      ]
    }
  }
}

Environment Variables

export GROUND_API_URL=https://ground-api.azurewebsites.net
export GROUND_API_KEY=your-api-key
npx @raptrx/ground-mcp

With API Key (Production)

{
  "mcpServers": {
    "ground": {
      "command": "npx",
      "args": ["@anthropic/ground-mcp", "--api-url", "https://api.ground.dev", "--api-key", "your-api-key"]
    }
  }
}

Environment Variables

export GROUND_API_URL=https://api.ground.dev
export GROUND_API_KEY=your-api-key
npx @anthropic/ground-mcp

Available Tools

ground_search

Search for code, documentation, or packages.

Query: "how to use useState hook"
→ Returns ranked results with citations

ground_chat

Get AI-powered answers with citations.

Query: "How do I implement authentication in Express?"
→ Returns answer with cited sources

ground_add_source

Add a new source (npm package, repo, or docs).

Add: { source_type: "package", url: "axios", ecosystem: "npm" }
→ Indexes the package for search

ground_list_sources

List all indexed sources with status.

ground_get_status

Get Ground server status.

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

License

MIT