How to Use the Gutendex MCP in Google ADK

Q: How do I register the Gutendex MCP Server in Google ADK?

Install the Google ADK package, define your McpToolset with the server's HTTP URL, and pass it to your LlmAgent in the tools parameter.

Q: Can my Google ADK agent filter Gutendex results by specific MIME types?

Yes, the listbooks tool allows filtering by MIME type, such as "application/pdf", so your agent only retrieves books available in your preferred format.

Feed 70,000+ public domain books directly into your Google ADK pipelines to power long-context Gemini reasoning.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gutendex MCP to Google ADK

Create your Vinkius account to connect Gutendex to Google ADK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Gutendex with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Search the Gutenberg catalog with Google ADK

The `list_books` tool connects your Gemini models to the entire Project Gutenberg library, enabling targeted searches by topic, language, and author. Your agent can pinpoint specific works, check their download counts, and filter by copyright status. This tool works natively with Google ADK's long-context capabilities, allowing your agent to pull metadata lists and select the exact books needed for deep reasoning. You can restrict tool access using the framework's optional filters during setup.

Retrieve structured book details via MCP Server

The `get_book` tool retrieves complete metadata for any specific book ID, including title, author life dates, subjects, and all available download formats. It provides direct URLs for EPUB, Kindle, and plain text files. Your enterprise agent can call this tool to fetch texts like Ulysses (ID 4300) or Romeo and Juliet (ID 1727) for analysis. The MCP Server formats the response so your model can immediately process the download links or author details.

Resolve raw web URLs into structured metadata

The `get_books_by_url` tool takes standard Project Gutenberg links and converts them back into structured book objects. When your agent processes documents containing raw URLs, it uses this tool to extract the corresponding metadata. This tool ensures your workflows do not break when encountering raw web paths. By integrating this server with Google ADK, your agents can crawl lists of external Gutenberg links and convert them into clean JSON data.

Setup guide

Set up Gutendex MCP in Google ADK

Prerequisites

Python 3.10+ installed
google-adk package (pip install google-adk)
Active Vinkius subscription with a valid endpoint token

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with Gutendex tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="Gutendex_agent",
    model="gemini-2.0-flash",
    instruction="You have access to Gutendex tools via MCP.",
    tools=mcp_tools,
)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Gutendex. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Gutendex now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Gutendex MCP in Google ADK

Install the Google ADK package, define your `McpToolset` with the server's HTTP URL, and pass it to your `LlmAgent` in the tools parameter.

Yes, the `list_books` tool allows filtering by MIME type, such as "application/pdf", so your agent only retrieves books available in your preferred format.

Yes, the server supports both transports, allowing you to run it locally or host it on Vinkius and connect via HTTP.

The server handles the connection to the public API, but you should configure your agent to avoid rapid, repetitive calls to `list_books` to prevent upstream IP blocks.

The server only processes public book metadata, search filters, and Gutenberg URLs. All traffic goes through Vinkius's zero-trust sandbox, ensuring your Google Cloud environment remains isolated and secure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript