REST API & MCP

API Documentation

Everything you need to integrate Curyloop into your workflows. Authenticate with API keys, manage groups and sessions, and connect via MCP for AI-powered access.

Full reference for all Curyloop MCP tools.

MCP Tools

ToolDescription
list_groupsList all groups you're a member of
list_sessionsList active/draft sessions in a group
list_itemsList all items in a session
add_itemAdd a new link/article/repo to a session
search_itemsSearch items across all your groups

list_groups

No parameters required. Returns all groups with your role.

list_sessions

ParameterTypeRequiredDescription
groupIdstringYesThe group ID

list_items

ParameterTypeRequiredDescription
sessionIdstringYesThe session ID

add_item

ParameterTypeRequiredDescription
sessionIdstringYesTarget session ID
groupIdstringYesGroup ID
urlstringYesURL to add
titlestringNoCustom title (auto-extracted if omitted)
descriptionstringNoYour notes
prioritystringNolow, medium, or high (default: medium)

search_items

ParameterTypeRequiredDescription
querystringYesSearch query