MCP Server

Connect your AI tools to Grid My Business using the Model Context Protocol (MCP), an open standard that lets AI assistants interact with your workspace.

MCP Server Icon

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI models to interact with local and remote data sources. By connecting the Grid My Business MCP server, you give your AI the ability to:

  • List your workspaces and browse all Google Business Profiles within them.
  • Run a full profile analysis to surface optimisation gaps and actionable insights.
  • List tracked keywords, inspect individual keyword details, and pull complete ranking history.
  • Analyse competitor profiles and local positioning to understand how you stack up.
  • Get AI-powered sentiment analysis across all your customer reviews at a glance.
  • Fetch Google Business performance metrics and audit your citation listings.

Connecting to MCP

Each tool has different steps to locate and configure the MCP server. Choose your tool below:

Claude

Claude Code
claude mcp add --transport http grid-my-business https://mcp.gridmybusiness.com/mcp

Then run /mcp once you've opened a Claude Code session to go through the authentication flow.

Use the /mcp command to list and manage the MCP servers you have installed, and use the /context command to understand the context token usage of your current session, including the number of tokens used by each MCP server that's enabled.

Claude desktop
  1. Navigate to Settings
  2. Go to the Developer tab
  3. Click Edit Config
  4. Add the configuration code below into your config file (claude_desktop_config.json):
{
  "mcpServers": {
    "grid-my-business": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.gridmybusiness.com/mcp",
        "--transport",
        "http-first"
      ],
      "disabled": false
    }
  }
}
  1. Quit Claude desktop and relaunch it to move through the authentication flow.

Codex

The setup steps for the MCP server are the same regardless of whether you use the IDE Extension or the CLI since the configuration is shared.

Configuration via CLI

Run the following command in Terminal:

codex mcp add grid-my-business --url https://mcp.gridmybusiness.com/mcp

This will automatically prompt you to log in and connect it to your Codex.

Configuration via app
  1. Navigate to Settings
  2. Go to the MCP servers tab
  3. Click Add server
  4. Select Streamable HTTP
  5. Type grid-my-business for the Name
  6. Copy link below and paste into the URL field:
https://mcp.gridmybusiness.com/mcp
  1. Click Save
  2. Click Authenticate to move through the authentication flow.
Configuration via environment variables:
  1. Open the ~/.codex/config.toml file in your preferred editor
  2. Add the following configuration:
[mcp_servers.gmb]
url = "https://mcp.gridmybusiness.com/mcp"

Then run codex mcp login gmb to move through the authentication flow.

Cursor

  1. Navigate to Settings
  2. Go to Tools & MCPs tab
  3. Click New MCP Server
  4. Add the configuration code below into your config file (~/.cursor/mcp.json):
{
  "mcpServers": {
    "grid-my-business": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.gridmybusiness.com/mcp",
        "--transport",
        "http-first"
      ],
      "disabled": false
    }
  }
}

Antigravity

  1. Navigate to Settings
  2. Go to Customizations tab
  3. Click Open MCP Config
  4. Add the configuration code below into your config file (~/.gemini/antigravity/mcp_config.json):
{
  "mcpServers": {
    "grid-my-business": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.gridmybusiness.com/mcp",
        "--transport",
        "http-first"
      ],
      "disabled": false
    }
  }
}

Frequently Asked Questions