How to Use the GitBook MCP in Mastra AI

Q: How do I register the GitBook MCP Server tools in my Mastra AI agent?

Instantiate the MCP client using the Mastra SDK and call listTools. You then spread these tools directly into your agent definition to give it full access to your spaces.

Q: Is my GitBook documentation content safe during Mastra execution?

All data fetched via getpage remains within your local Mastra execution context. The MCP Server runs inside an ephemeral, zero-trust sandbox that destroys all session data immediately after execution.

Build resilient documentation auditing workflows with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GitBook MCP to Mastra AI

Create your Vinkius account to connect GitBook to Mastra AI 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 GitBook with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run automated GitBook audits using Mastra AI

The `list_pages` tool fetches all document paths within a GitBook space so your Mastra AI agent can verify structure. It feeds GitBook page lists directly into your Mastra workflows to verify compliance with your style guide. If a GitBook page fails verification, Mastra's workflow engine triggers a retry or routes the issue to your team. You get automated checks across your GitBook spaces without worrying about transient API failures.

Check GitBook permissions across your Mastra AI workflows

The `get_me` tool verifies the identity of the active GitBook session before running any Mastra AI scripts. Mastra AI uses this tool to ensure only authorized team members trigger deep audits. Combining this with `list_organizations` lets you build multi-tenant Mastra AI workflows. Your agents automatically route GitBook tasks to the correct organizational workspace.

Deep GitBook content search with an MCP Server

The `search_content` tool executes targeted queries across your GitBook spaces to find stale technical terms. Your Mastra AI agents use this to locate deprecated API keys or outdated product names in your docs. You can configure manual approvals in Mastra AI so that a human reviews the GitBook search results before flagging them. This keeps your automated GitBook documentation cleanup highly accurate.

Setup guide

Set up GitBook MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All GitBook tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "gitbook-mcp-client",
  servers: {
    "gitbook-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "GitBook Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to GitBook tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent GitBook transactions"
);
console.log(result.text);

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 GitBook. 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 GitBook 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 GitBook MCP in Mastra AI

Instantiate the MCP client using the Mastra SDK and call `listTools`. You then spread these tools directly into your agent definition to give it full access to your spaces.

No, this MCP Server operates on a read-only basis. While tools like `get_space` and `get_page` let you audit content, you must use external webhooks to apply changes.

Mastra's built-in workflow engine supports exponential backoff. When tools like `get_page` hit API limits, the engine automatically pauses and retries the request.

Yes, you can selectively register tools from the server during client initialization. For instance, you can expose only `search_content` to your Mastra AI agents while keeping administrative tools hidden.

All data fetched via `get_page` remains within your local Mastra execution context. The MCP Server runs inside an ephemeral, zero-trust sandbox that destroys all session data immediately after execution.

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