Merge Unified's Guru integration Merge Agent Handler's Guru MCP server

Connect your AI Agents to Guru in minutes

Merge lets you securely connect your agents to Guru and thousands of tools instantly

Start building for free

Read docs

Guru

Learn more about Merge Agent Handler

Available tools

list_boards

List Guru boards with pagination. Boards are home folders that organize cards into structured views. Use cursor from page_info for next page. Note: boards are filtered client-side from folders, so some pages may return fewer results.

get_board

Get a Guru board by ID with sections and items. Use list_boards to find board IDs.

search_cards

Search Guru cards by keywords with optional filters. Returns up to 50 cards per page. Use token from page_info.cursor for next page.

get_card

Get a Guru card by ID with full details including content, owner, collection, and tags. Use search_cards to find card IDs.

create_card

Create a new Guru card with title and content. Use list_collections to find a collection ID. Set shareStatus to TEAM for team-visible cards.

update_card

Update a Guru card's title, content, tags, or share status. Both title (preferredPhrase) and content are required. Use get_card to see current values.

delete_card

Permanently delete a Guru card. This action cannot be undone. Use get_card to verify the card before deleting.

verify_card

Mark a Guru card as verified/trusted. Use searchcards or getcard to find cards needing verification.

list_collections

List Guru collections with pagination. Optionally filter by search term. Use cursor from page_info for next page.

get_collection

Get a Guru collection by ID with full details. Use list_collections to find collection IDs.

list_card_comments

List comments on a Guru card with pagination. Use searchcards or getcard to find card IDs. Use cursor from page_info for next page. Note: this endpoint may return all comments in a single response.

create_card_comment

Add a comment to a Guru card. Use searchcards or getcard to find card IDs.

delete_card_comment

Delete a comment from a Guru card. Use listcardcomments to find comment IDs.

list_folders

List Guru folders with pagination. Returns folder hierarchy with collection references. Use cursor from page_info for next page.

get_folder

Get a Guru folder by ID with details. Use list_folders to find folder IDs.

create_folder

Create a new folder in a Guru collection. Use list_collections to find a valid collection ID.

update_folder

Update a Guru folder's title or description. Use get_folder to see current values.

delete_folder

Permanently delete a Guru folder. This action cannot be undone.

list_folder_items

List items (cards and subfolders) in a Guru folder with pagination. Use listfolders or getfolder to find folder IDs. Use cursor from page_info for next page. Note: this endpoint may return all items in a single response.

list_groups

List Guru user groups with pagination. Groups control access to collections and cards. Use cursor from page_info for next page.

list_members

List Guru team members with pagination. Returns roles and status. Use cursor from page_info for next page.

list_tag_categories

List Guru tag categories with their tags and pagination. Each category contains tags that can be applied to cards. Use cursor from page_info for next page. Note: this endpoint may return all categories in a single response.

create_tag

Create a new tag in a Guru tag category. Use listtagcategories to find valid category IDs.

list_templates

List Guru card templates with pagination. Templates provide reusable content structures for creating cards. Use cursor from page_info for next page. Note: this endpoint may return all templates in a single response.

get_template

Get a Guru card template by ID with full content. Use list_templates to find template IDs.

validate_credential

Validate Guru credentials by checking the authenticated user. Returns success status and message.

View all tools by creating a free account See more tools

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11

Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}

Copy Code

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }

Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}

Copy Code

FAQs on using Merge's Guru MCP server

What is a Guru MCP?

A Guru MCP is a server that exposes your Guru knowledge base to AI agents as callable tools. Your agents can invoke these tools to search and retrieve cards, create new knowledge entries, verify trusted content, browse collections, and more.

Guru offers an official MCP server, but you can also connect to a Guru MCP through a third-party platform like Merge Agent Handler.

How can I use the Guru MCP server?

The use cases naturally depend on the agent you've built, but here are a few common ones:

Contextual knowledge retrieval during support: When a support ticket arrives and is tagged with a specific issue type, an agent can search Guru for matching cards, extract the relevant content, and include it in a draft response for the support rep to review

Automated verification reminders: An agent can query Guru for cards past their verification date, compile a list of card owners and titles, and post a structured reminder to a Slack channel so the right people know what content needs review

Onboarding knowledge delivery: When a new hire is added to a connected HR system, an agent can search Guru for onboarding-tagged cards in the relevant department collection and deliver them directly to the new employee via email or messaging tool

Decision capture from project tools: When a discussion in a project management tool reaches a defined decision state, an agent can create a new card in Guru under the appropriate collection, capturing the context, decision summary, and owner for future reference

What are popular tools for Guru's MCP server?

Here are some of the most commonly-used tools:

<code class="blog_inline-code">search_cards</code> searches Guru cards by keyword or phrase and returns matching results with metadata. Useful for agents that need to surface relevant knowledge in response to a trigger from another system

<code class="blog_inline-code">get_card</code> fetches a single Guru card by ID, including its full content, tags, and verification status. Call this when an agent needs the complete text of a specific card before generating a response or summary

<code class="blog_inline-code">create_card</code> creates a new card in Guru under a specified collection or board. Good for workflows that capture decisions, meeting notes, or external context into the knowledge base automatically

<code class="blog_inline-code">update_card</code> modifies the content, title, or metadata of an existing Guru card. Use this when an agent detects that a card is outdated and needs to reflect new information from another system

<code class="blog_inline-code">verify_card</code> marks a Guru card as verified, confirming its content is current and trusted. Helpful when an agent needs to close out a review workflow after approval conditions are met

<code class="blog_inline-code">list_collections</code> returns all collections in a Guru workspace with their names and IDs. Use this when an agent needs to identify the right collection before creating or routing new cards

What makes Merge Agent Handler's Guru MCP server better than alternative Guru MCP servers?

Here is what sets Merge Agent Handler's Guru MCP server apart from alternatives:

Enterprise-grade security and DLP: Merge Agent Handler includes built-in data loss prevention controls that let you block or redact sensitive fields before they reach an agent. For Guru, this means internal process documentation, proprietary company knowledge, and sensitive team information can be masked even when the agent has broad card access

Managed authentication and credentials: Merge stores and refreshes Guru credentials on your behalf. You never pass API tokens directly to an agent or build logic to handle credential rotation

Real-time observability and audit trail: Every tool call against Guru is recorded with timestamp, tool name, input parameters, and response metadata. Knowledge management and ops teams get a complete log of what the agent read, created, or modified without any custom instrumentation

Tool Packs and controlled access: Tool Packs let you define exactly which Guru tools an agent can use, and combine them with tools from other connectors in a single scoped MCP endpoint. A retrieval agent gets search and read tools. A content maintenance agent gets update and verify tools. Each is scoped to its specific function

How can I start using Merge Agent Handler's Guru MCP server?

You can take the following steps:

1. Create or log into your Merge Agent Handler account and navigate to Tool Packs (collections of connector tools scoped to a specific use case).

2. Create a new Tool Pack (a collection of connectors and tools that maps to a use case) and enable the Guru connector. Select which tools to include. Search and read tools cover most knowledge retrieval workflows, while write tools are available if your agent needs to create cards, update content, or manage folders.

3. Add a Registered User to the Tool Pack. This defines the identity context your agent operates under, and Merge generates a unique MCP URL tied to that user.

4. From the Registered User detail page, complete the Guru credential flow. Merge takes over credential storage and refresh from that point forward.

5. Copy the MCP URL from the Tool Pack detail page and generate an API key under Settings. You will need both to connect your agent.

6. Add the MCP server configuration to your agent or IDE using the MCP URL and API key. Your Guru tools are accessible through that endpoint immediately.