How to Use the Gutendex MCP in LangChain

Q: How does LangChain use the Gutendex MCP server to filter books by language?

Your LangChain agent calls listbooks with specific ISO two-letter language codes like 'en' or 'fr'. The agent processes the returned array of books to filter down to the exact translations your chain requires.

Q: Can I track Gutendex tool latency inside LangChain with LangSmith?

Yes, every call to getbook or listbooks shows up in your LangSmith trace. You can inspect the exact payload, execution time, and token usage for each Gutenberg query.

Q: How do I handle pagination with Gutendex in a LangChain agent?

Your agent uses the getbooksbyurl tool to follow the next-page links returned by an initial search. This allows the LangChain loop to fetch subsequent pages of book results dynamically.

Run multi-step book research chains using LangChain to query and analyze 70,000+ Project Gutenberg texts instantly.

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 LangChain

Create your Vinkius account to connect Gutendex to LangChain 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 LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain Gutenberg queries in LangChain

The `list_books` tool acts as the entry point for your LangChain chains, letting your agent search the Gutenberg database by language, topic, or author era. Your agent can feed the resulting list of popular titles directly into subsequent processing nodes without manual parsing. Because this MCP server integration lets you track every step, you can observe exactly how the agent refines its search queries based on the publication years or download counts returned. This makes it easy to build research pipelines that find relevant classics and pull their metadata in a single run.

Resolve raw Gutenberg URLs automatically

The `get_books_by_url` tool resolves raw Project Gutenberg links directly inside your active LangChain execution threads. When a user drops a standard ebook URL into the chat, your agent intercepts it and fetches the precise metadata payload. This tool extracts the book ID and formats, passing the clean data to the next step in your chain. You can monitor the entire payload transfer in LangSmith to verify that the correct download links are passed to your downstream document parsers.

Extract complete ebook metadata on demand

The `get_book` tool retrieves the full catalog details for any specific Project Gutenberg ID, including every available download format from EPUB to plain text. Your LangChain agent calls this tool to gather the exact file paths needed before initiating a download or analysis step. By isolating this lookup, your agent avoids wasting context window space on broad searches. It gets the exact payload for classics like Frankenstein or Moby Dick, ensuring your chain has the precise URLs required for further processing.

Setup guide

Set up Gutendex MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes Gutendex tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "gutendex-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent Gutendex transactions"
    })
    print(result["messages"][-1].content)

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 LangChain

Your LangChain agent calls `list_books` with specific ISO two-letter language codes like 'en' or 'fr'. The agent processes the returned array of books to filter down to the exact translations your chain requires.

Yes, every call to `get_book` or `list_books` shows up in your LangSmith trace. You can inspect the exact payload, execution time, and token usage for each Gutenberg query.

Your agent uses the `get_books_by_url` tool to follow the next-page links returned by an initial search. This allows the LangChain loop to fetch subsequent pages of book results dynamically.

No, this server requires zero API keys or authentication headers. You simply initialize the client and your agent can immediately query the entire catalog.

All book metadata lookups and search queries run through a secure V8 sandbox on Vinkius. Your search terms and requested ebook IDs are never stored or shared with third parties.

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