How to Use the Gutendex MCP in VS Code Copilot

Q: How do we configure Gutendex for our entire team in VS Code Copilot?

You can add the server configuration to a shared .vscode/mcp.json file in your repository. This allows every developer on the team to use the tools automatically when they open the project.

Q: Can VS Code Copilot use Gutendex to fetch metadata from a Gutenberg URL?

Yes, Copilot can call the getbooksbyurl tool to resolve standard links. This returns structured JSON data containing the book's title, author, and formats.

Q: Does this MCP server support pagination for large search results?

Yes, the listbooks tool supports pagination natively. You can request subsequent pages of results to navigate through the entire catalog of over 70,000 books.

Share Project Gutenberg catalog access across your entire development team using VS Code Copilot.

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 VS Code Copilot

Create your Vinkius account to connect Gutendex to VS Code Copilot 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 VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Standardize book metadata integration with this MCP Server

Keep your engineering team on the same page. By committing the configuration to your repository, every developer gets instant access to the public domain catalog via the MCP server. Your team can build and test library integrations without managing individual API keys or local database dumps. The `list_books` tool allows Copilot to query the index and return consistent JSON structures. This prevents integration bugs caused by developers using different versions of the public catalog schema.

Parse web links into structured data blocks

Processing raw URLs is a common source of bugs in content management systems. With `get_books_by_url`, your team can verify how their applications handle Gutenberg links. Copilot uses this tool to fetch the exact metadata associated with any valid web link. This simplifies the development of ingestion pipelines. It ensures that your code correctly maps external URLs to the right database records.

Retrieve direct download links for testing

Testing file converters requires access to various document formats. The `get_book` tool provides direct URLs to PDF, Kindle, EPUB, and plain text files for classic IDs like Pride and Prejudice or Frankenstein. This gives your team a reliable source of test files. Copilot can write automated tests that fetch these files, ensuring your conversion pipelines handle real formatting quirks.

Setup guide

Set up Gutendex MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Gutendex MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Gutendex tools listed. Try asking: "List my recent Gutendex transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "gutendex-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 VS Code Copilot

You can add the server configuration to a shared `.vscode/mcp.json` file in your repository. This allows every developer on the team to use the tools automatically when they open the project.

Yes, Copilot can call the `get_books_by_url` tool to resolve standard links. This returns structured JSON data containing the book's title, author, and formats.

Ask Copilot to search for books by author, subject, or language. It will use the `list_books` tool to fetch matching titles sorted by popularity.

Yes, the `list_books` tool supports pagination natively. You can request subsequent pages of results to navigate through the entire catalog of over 70,000 books.

The MCP server only processes the specific book IDs, search terms, and Gutenberg URLs you request. Your team's source code, repository files, and internal discussions are never exposed to the public metadata service.

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