How to Use the Guru MCP in Claude Code

Q: How does Claude Code search my Guru wiki?

The CLI agent calls searchknowledgebase with your query terms to scan all available boards. It returns the most relevant markdown cards directly inside your terminal window.

Q: How do I configure the Guru MCP Server in Claude Code?

Run the command claude mcp add --transport http guru-mcp -- in your terminal. Once added, the CLI will instantly register the 12 tools for your next session.

Q: Can I run this MCP tool from a shell script?

Yes. The agent runs verifyapiconnection to test your credentials and ensure your terminal has direct access to the API.

Pipe your Guru wiki directly into your terminal workflows using the Claude Code CLI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Guru MCP to Claude Code

Create your Vinkius account to connect Guru to Claude Code 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 Guru with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Terminal-driven search via Claude Code

Ditch the browser entirely when looking for internal documentation. This CLI agent uses `search_knowledge_base` to query your entire wiki directly from your shell prompt. It extracts the raw markdown and displays it right in your terminal. When you are debugging a production incident, every second counts. The agent runs `get_card_details` to quickly grab runbooks and troubleshooting steps, letting you fix issues without losing focus on your SSH session.

Automate wiki maintenance via MCP Server

Maintaining documentation in CI/CD pipelines is finally possible. Your terminal agent can use this MCP Server to run `update_knowledge_card` automatically during a release process to update version numbers or deployment notes. It keeps your wiki accurate with zero manual overhead. By using `list_knowledge_cards`, the agent can audit your entire documentation catalog for outdated files. It flags stale content during your scheduled cron jobs so your wiki stays fresh.

Manage boards from your shell

Organizing your team knowledge shouldn't require clicking through a GUI. The CLI uses `list_knowledge_boards` to map out your documentation structure directly from the command line. It lets you inspect how your wiki is organized before making bulk changes. If you need to audit team access, the agent calls `list_access_groups` to verify which teams can read specific boards. It outputs clean lists that you can pipe into other command-line utilities.

Setup guide

Set up Guru MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see guru-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Guru transactions." It will automatically discover and invoke the available Guru tools.

Terminal

claude mcp add --transport http guru-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Guru MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "guru-mcp": {
      "type": "url",
      "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 Guru. 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 Guru 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 Guru MCP in Claude Code

Yes. You can pipe a list of files into Claude Code and tell it to use `update_knowledge_card` to sync those changes to your wiki. This makes bulk updates fast and scriptable.

The CLI agent calls `search_knowledge_base` with your query terms to scan all available boards. It returns the most relevant markdown cards directly inside your terminal window.

Run the command `claude mcp add --transport http guru-mcp -- ` in your terminal. Once added, the CLI will instantly register the 12 tools for your next session.

Yes. The agent runs `verify_api_connection` to test your credentials and ensure your terminal has direct access to the API.

All transmission of your knowledge cards and wiki data is encrypted using transport-layer security directly to Guru's API. Vinkius hosts the connector in a secure sandbox that never caches your secrets or writes your documentation content to persistent storage.

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