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
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
