> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/mcp/introduction/getting-started/google-adk/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Google ADK

> **Tip**
>
> The Google Agent Development Kit (ADK) is intended for programmatic agent development and backend integrations. For interactive use, see [Gemini CLI](/mcp/introduction/getting-started/gemini-cli).

The Google Agent Development Kit (ADK) can connect to Ada's MCP server using the `MCPToolset` class. This enables programmatic access to Ada's MCP tools within ADK-based agents.

Ada's MCP server currently supports **JSON-RPC 2.0 over HTTP** at the `/api/mcp` endpoint. Server-Sent Events (SSE) streaming is not available.

## Requirements

* Python 3.10 or later.

* Google ADK installed:

  ```bash
  pip install google-adk
  ```

* An API key generated from **Config > PLATFORM > API keys** in your Ada dashboard.

## Configuration

1. Generate an API key from **Config > PLATFORM > API keys** in your Ada dashboard.

2. Set your Ada API key as an environment variable:

   ```bash
   export ADA_API_KEY=your_api_key_here
   ```

3. Connect to Ada's MCP server:

   ```python
   import asyncio
   import os
   from google.adk.toolsets import MCPToolset

   async def main():
       ada_toolset = await MCPToolset.from_server(
           connection_params={
               "url": "https://acme-corp.ada.support/api/mcp",
               "headers": {
                   "Authorization": f"Bearer {os.environ['ADA_API_KEY']}"
               }
           }
       )

       tools = ada_toolset.get_tools()
       print(f"Loaded {len(tools)} Ada MCP tools")

   asyncio.run(main())
   ```

4. Replace `acme-corp.ada.support` with your Ada instance domain (see [Authentication](/mcp/introduction/authentication)).

5. Ensure `ADA_API_KEY` is set in your environment before running the script.

## Endpoint

Ada's MCP server is exposed at the `/api/mcp` endpoint and routed by subdomain.

* Production: `https://<your-subdomain>.<your-ada-domain>/api/mcp`
* Local development: `http://<subdomain>.localhost:8000/api/mcp`

## Common issues

**401 Unauthorized**

* Ensure your API key is valid.
* Verify the Authorization header is formatted as `Bearer <key>`.

**405 Method Not Allowed**

* Ensure you are sending POST requests to `/api/mcp`.
* SSE (GET streaming) is not supported.