Connect your AI Agents to Guru in minutes

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 search_cards or get_card 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 search_cards or get_card 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 search_cards or get_card to find card IDs.
delete_card_comment
Delete a comment from a Guru card. Use list_card_comments 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 list_folders or get_folder 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 list_tag_categories 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.

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}
11Open 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}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 }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}FAQs on using Merge's Guru MCP server
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.
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now

























