Gemini SDK

Google’s Gemini API includes built-in support for MCP servers in their Python and JavaScript SDKs, allowing you to connect directly to MCP servers and use their tools seamlessly with Gemini models.

​

Gemini Python SDK

Google’s Gemini Python SDK can use FastMCP clients directly.

​

Create a Server

First, create a FastMCP server with the tools you want to expose. For this example, we’ll create a server with a single tool that rolls dice.

import random
from fastmcp import FastMCP

mcp = FastMCP(name="Dice Roller")

@mcp.tool()
def roll_dice(n_dice: int) -> list[int]:
    """Roll `n_dice` 6-sided dice and return the results."""
    return [random.randint(1, 6) for _ in range(n_dice)]

if __name__ == "__main__":
    mcp.run()

​

Call the Server

To use the Gemini API with MCP, you’ll need to install the Google Generative AI SDK:

pip install google-genai

You’ll also need to authenticate with Google. You can do this by setting the GEMINI_API_KEY environment variable. Consult the Gemini SDK documentation for more information.

export GEMINI_API_KEY="your-api-key"

Gemini’s SDK interacts directly with the MCP client session. To call the server, you’ll need to instantiate a FastMCP client, enter its connection context, and pass the client session to the Gemini SDK.

from fastmcp import Client
from google import genai
import asyncio

mcp_client = Client("server.py")
gemini_client = genai.Client()

async def main():    
    async with client:
        response = await gemini_client.aio.models.generate_content(
            model="gemini-2.0-flash",
            contents="Roll 3 dice!",
            config=genai.types.GenerateContentConfig(
                temperature=0,
                tools=[mcp_client.session],  # Pass the FastMCP client session
            ),
        )
        print(response.text)

if __name__ == "__main__":
    asyncio.run(main())

If you run this code, you’ll see output like:

Okay, I rolled 3 dice and got a 5, 4, and 1.

​

Remote & Authenticated Servers

In the above example, we connected to our local server using stdio transport. Because we’re using a FastMCP client, you can also connect to any local or remote MCP server, using any transport or auth method supported by FastMCP, simply by changing the client configuration.

For example, to connect to a remote, authenticated server, you can use the following client:

from fastmcp import Client
from fastmcp.client.auth import BearerAuth

client = Client(
    "https://my-server.com/sse",
    auth=BearerAuth("<your-token>"),
)

The rest of the code remains the same.