Google ADK

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:

  $
  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:

   $
   export ADA_API_KEY=your_api_key_here

3. Connect to Ada’s MCP server:

   1
   import asyncio
   2
   import os
   3
   from google.adk.toolsets import MCPToolset
   4
   5
   async def main():
   6
       ada_toolset = await MCPToolset.from_server(
   7
           connection_params={
   8
               "url": "https://acme-corp.ada.support/api/mcp",
   9
               "headers": {
   10
                   "Authorization": f"Bearer {os.environ['ADA_API_KEY']}"
   11
               }
   12
           }
   13
       )
   14
   15
       tools = ada_toolset.get_tools()
   16
       print(f"Loaded {len(tools)} Ada MCP tools")
   17
   18
   asyncio.run(main())

4. Replace acme-corp.ada.support with your Ada instance domain (see 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.