# AutoPostcode MCP for Gemini CLI and Antigravity

Configure Google Gemini CLI or Antigravity for AutoPostcode’s UK address MCP server. See the verified steps for Gemini CLI and the limits of each Google client.

Canonical page · https://autopostcode.com/gemini-mcp

## Which Gemini client should I use?

This guide covers Google’s developer clients. The consumer Gemini app connection was not tested here. Google moved free individual and Google AI Pro and Ultra command-line access to Antigravity CLI in June 2026. Check Google’s current eligibility guidance if you use Gemini CLI with a business or enterprise account.

On 22 November 2026, Gemini CLI 0.70.0 reported Connected to the live AutoPostcode endpoint from a trusted test folder. Its model-driven call stopped at Google authentication setup, so no Gemini tool invocation or authenticated AutoPostcode call was confirmed. Antigravity remains unverified.

- [Google’s Gemini CLI project and transition guidance](https://github.com/google-gemini/gemini-cli)

- [Google Antigravity MCP guide](https://antigravity.google/docs/mcp?tab=cli)

## Connect in Gemini CLI

Gemini CLI’s http transport selects Streamable HTTP. User scope saves the server in your user settings. Gemini CLI disables both project and user MCP connections in an untrusted workspace, and requires a configured Google authentication method for model turns.

1. Open a workspace you trust. Run the add command with --scope user, then check that gemini mcp list reports Connected.
2. Start a Gemini CLI session with your eligible Google account. Use /mcp to see server and tool discovery in the session.
3. Use the free test prompt. Verify the client invoked get_product_facts and that the result shows United Kingdom.

- [Google’s Gemini CLI MCP reference](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html)

- [AutoPostcode MCP tool reference](https://autopostcode.com/mcp-docs#tools)

Add and list the server in Gemini CLI

```bash
gemini mcp add --scope user --transport http autopostcode https://autopostcode.com/mcp
gemini mcp list
```

Free test prompt

```text
Use the AutoPostcode MCP tool get_product_facts with no arguments. Tell me the coverage region from the tool result. Do not use web search or run a postcode lookup.
```

## Configure Google Antigravity CLI

Google documents Streamable HTTP servers in the Antigravity CLI MCP manager and workspace configuration. A live Antigravity connection and tool call remain unverified.

1. Open the Antigravity CLI MCP manager with /mcp. You can also use the workspace configuration file .agents/mcp_config.json.
2. Add AutoPostcode as a remote server using the serverUrl entry below. Leave authentication empty for the public facts check.
3. Check the server and tools in the MCP manager, then use the public test prompt. Confirm a visible tool result before relying on the connection.

- [Antigravity CLI configuration](https://antigravity.google/docs/mcp?tab=cli)

Antigravity CLI .agents/mcp_config.json

```json
{
  "mcpServers": {
    "autopostcode": {
      "serverUrl": "https://autopostcode.com/mcp"
    }
  }
}
```

## Authentication and UK postcode lookup

AutoPostcode private tools require an Authorization Bearer header containing an owner-issued agent key. Check your Google client’s header and secret configuration before attempting to connect. Authenticated AutoPostcode calls from these Google clients remain unverified.

Keep keys out of chat and checked-in settings. With a client that can securely send the header, use a connection:read key and get_connection_status as the first zero-credit authentication check. A matched postcode lookup can consume a credit.

- [Create a connection-only agent key](https://autopostcode.com/dashboard/developer)

- [AutoPostcode MCP errors](https://autopostcode.com/api-error-handling#mcp-errors)
