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.

Connect Curyloop to Windsurf IDE for AI-powered content curation. Let Cascade manage your research workflow while you code.

Windsurf + Curyloop

Connect Curyloop to Windsurf IDE and let Cascade, Windsurf's AI assistant, manage your research and content curation workflow.

Setup

Add to your .windsurf/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 your key from Settings > API Keys.

What You Can Do

With Curyloop connected to Windsurf, Cascade can:

  • Discover resources while you focus on coding
  • Save documentation and tutorials without context switching
  • Organize findings by project, topic, or priority
  • Search your knowledge base for previously saved content

Example Prompts

Automated Research

Find the top 5 articles about serverless architecture patterns,
evaluate each one for quality, and save the best ones to my
"Architecture" session in Curyloop with tags and descriptions.

Framework Migration

I'm migrating from Express to Hono. Find migration guides,
comparison articles, and best practices. Save them to my
"Express to Hono" session in Curyloop.

Security Audit Resources

Find the OWASP top 10 resources, security checklists, and
penetration testing guides for web applications. Save to my
"Security Audit" session with high priority.

State Management

Research the current state management landscape for React -
Zustand, Jotai, Redux Toolkit, and TanStack Query. Find the
best comparison articles and save to "State Management" session.

Available MCP Tools

ToolDescription
list_groupsList all your Curyloop groups
list_sessionsList sessions in a group
list_itemsList items in a session
add_itemAdd a new item to a session
search_itemsSearch across all your items

Tips

  • Cascade's Flows feature works well for multi-step research tasks
  • Use Windsurf's context awareness to find project-relevant resources
  • Combine with Windsurf's code generation for informed development
  • Great for discovering alternatives and comparing tools

For general MCP setup details, see MCP Setup. For more AI agent examples, see AI Agents.