Use CuryLoop as an MCP (Model Context Protocol) server to manage your knowledge base directly from AI assistants like Claude.

MCP Integration

CuryLoop exposes an MCP-compatible server that lets you interact with your groups, sessions, and items directly from AI assistants like Claude Desktop, Claude Code, Cursor, and other MCP clients.

Quick Setup

Claude Desktop

Add this to your ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json

{
  "mcpServers": {
    "curyloop": {
      "type": "streamable-http",
      "url": "https://curyloop.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Run this command in your terminal:

bash

claude mcp add curyloop \
  --transport http \
  --url https://curyloop.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Add to your .cursor/mcp.json:

json

{
  "mcpServers": {
    "curyloop": {
      "type": "streamable-http",
      "url": "https://curyloop.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with an API key from Settings > API Keys.

Available Tools

Tool	Description
`list_groups`	List all groups you're a member of
`list_sessions`	List active/draft sessions in a group
`list_items`	List all items in a session
`add_item`	Add a new link/article/repo to a session
`search_items`	Search items across all your groups

Usage Examples

Once configured, you can use natural language with your AI assistant:

"Show me my CuryLoop groups"
"List the sessions in my Engineering group"
"Add https://github.com/vercel/next.js to our current session"
"Search for articles about TypeScript in CuryLoop"

Tool Details

list_groups

No parameters required. Returns all groups with your role.

list_sessions

Parameter	Type	Required	Description
`groupId`	string	Yes	The group ID

list_items

Parameter	Type	Required	Description
`sessionId`	string	Yes	The session ID

add_item

Parameter	Type	Required	Description
`sessionId`	string	Yes	Target session ID
`groupId`	string	Yes	Group ID
`url`	string	Yes	URL to add
`title`	string	No	Custom title (auto-extracted if omitted)
`description`	string	No	Your notes
`priority`	string	No	`low`, `medium`, or `high` (default: medium)

search_items

Parameter	Type	Required	Description
`query`	string	Yes	Search query

Authentication

The MCP server uses the same API key authentication as the REST API. Include your key as a Bearer token in the Authorization header.

Endpoint

POST https://curyloop.com/api/mcp

The server implements the MCP JSON-RPC protocol (version 2025-03-26) over HTTP.

API Documentation