Skip to main content
The Swoop MCP server lets you create and manage presentations from any AI client that supports the Model Context Protocol (MCP). Instead of switching to the Swoop dashboard, you can work directly from Claude Desktop, Cursor, or any other MCP-compatible tool.

Endpoint

The Swoop MCP server is available at: The server uses Streamable HTTP transport with Server-Sent Events (SSE) for real-time streaming.

Available tools

The MCP server exposes a single tool, ask_swoopAgent, which sends your request to the Swoop orchestrator agent.

Input parameters

prompt
string
required
Your request to Swoop. Describe the presentation you want to create, edit, or manage.
threadId
string
Thread ID from a previous interaction. Reuse this to continue a conversation and maintain context across multiple requests.

Response fields

FieldTypeDescription
responsestringThe agent’s text response
threadIdstringThread ID to reuse in follow-up requests
projectIdstringThe active presentation project ID
dashboardLinkstringURL to view or edit the presentation in the Swoop dashboard
toolResultsarrayResults from internal tools (outline creation, slide generation, etc.)

How it works

  1. Your AI client sends a request to the Swoop MCP server
  2. The server authenticates your request via OAuth or API key
  3. Your prompt is forwarded to the Swoop orchestrator agent
  4. The agent creates, edits, or manages your presentation
  5. The response is streamed back to your client with structured output
Presentation generation can take 30-60 seconds. The server sends progress heartbeats every 10 seconds to keep the connection alive during long operations.

Next steps