Skip to main content
The Swoop MCP server exposes a single tool that routes requests to the Swoop presentation agent.

​
ask_swoopAgent

Use this tool to create, edit, or manage presentations. Your prompt is forwarded to the Swoop agent, which coordinates internal tools to fulfill your request.

​
Characteristics

​
Input parameters

​
string
required
Your request to Swoop. Describe the presentation you want to create, edit, or manage. Be as specific as possible — include details about topic, number of slides, tone, audience, and any structural preferences.
​
string
Thread ID from a previous interaction. Reuse this to continue a conversation and maintain context across multiple requests. The agent uses the thread to recall prior instructions, outlines, and edits.

​
Output

The tool returns a structured response with the following fields:

​
Structured output

The Swoop MCP server supports MCP structured output. Tool responses include both:
  • content — An array of text content blocks containing the JSON-stringified form of the structured data, for human-readable display and backwards compatibility
  • structuredContent — The same payload as a parsed object, validated against the tool’s output schema for programmatic access
Clients that support structured output can use structuredContent for programmatic access to response fields like projectId, dashboardLink, and toolResults without parsing text.

​
Progress notifications

Presentation generation can take 30–60 seconds. When your client provides a progressToken in the tool call’s _meta field, the server sends periodic notifications/progress messages every 10 seconds. These heartbeats keep the connection alive and signal that the operation is still in progress.
If you are building a custom MCP client, ensure your transport layer can handle long-lived connections (at least 120 seconds) and process incoming SSE notifications during tool execution.

​
Example workflow

A typical interaction follows this pattern:
1

Create a presentation

Call ask_swoopAgent with a descriptive prompt:
2

Review the response

The response includes a dashboardLink to preview the presentation and a threadId for follow-up requests.
3

Iterate on the content

Use the same threadId to refine the presentation: