MCP: Grounder docs

Connect an agent

Agents connect to https://api.grounder.net/mcp over streamable HTTP. Add that address to your client; when it opens Grounder’s screen, sign in with Google, GitHub or Apple and allow it. There’s no key to copy.

ConnectorsClaude

# Customize, Connectors, + Add,
# Add custom connector
Name  grounder
URL   https://api.grounder.net/mcp
# Add, then Connect and sign in.
# No key needed.

# So Claude searches with Grounder:
# Customize, Skills, +, Create skill,
# Upload a skill
Skill grounder-web-search.zip

# chatgpt.com/plugins, +,
# Add custom MCP server
Name  grounder
URL   https://api.grounder.net/mcp
Auth  OAuth
# Create and sign in, then type
# @grounder in a new chat.

claude mcp add --transport http \
  grounder \
  https://api.grounder.net/mcp
# then /mcp, grounder, Authenticate

codex mcp add grounder \
  --url https://api.grounder.net/mcp
codex mcp login grounder

copilot mcp add --transport http \
  grounder \
  https://api.grounder.net/mcp
# then start copilot and sign in

gemini mcp add -s user -t http \
  grounder \
  https://api.grounder.net/mcp
# then /mcp auth grounder in a session

{
  "mcp": {
    "grounder": {
      "type": "remote",
      "url": "https://api.grounder.net/mcp"
    }
  }
}
// then opencode mcp auth grounder

openclaw mcp add grounder \
  --url https://api.grounder.net/mcp \
  --transport streamable-http \
  --auth oauth
openclaw mcp login grounder

hermes mcp add grounder \
  --url https://api.grounder.net/mcp \
  --auth oauth --connect-timeout 300
# sign in as it adds

pi mcp add grounder \
  --url https://api.grounder.net/mcp \
  --exposure direct
pi mcp login grounder

extensions:
  grounder:
    enabled: true
    type: streamable_http
    name: grounder
    uri: https://api.grounder.net/mcp
    timeout: 300
# sign in when a session starts

{
  "servers": {
    "grounder": {
      "type": "http",
      "url": "https://api.grounder.net/mcp"
    }
  }
}
// sign in when VS Code starts it

{
  "mcpServers": {
    "grounder": {
      "url": "https://api.grounder.net/mcp"
    }
  }
}
// then Cursor Settings, MCP, grounder

{
  "context_servers": {
    "grounder": {
      "url": "https://api.grounder.net/mcp"
    }
  }
}
// then Authenticate, beside grounder

// Settings, MCP, Add, then paste:
{
  "grounder": {
    "url": "https://api.grounder.net/mcp"
  }
}
// sign in when it starts

{
  "mcpServers": {
    "grounder": {
      "type": "http",
      "url": "https://api.grounder.net/mcp"
    }
  }
}

{
  "mcpServers": {
    "grounder": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.grounder.net/mcp"
      ]
    }
  }
}
// for clients without remote sign-in

Tools

The server exposes search, list_providers, record_user_response, and user_info.

Search keys

A search key made earlier works here too: send it as Authorization: Bearer <key> instead of signing in.