Gumloop is an AI automation platform for building agents and workflows. The Gumloop MCP server lets you manage flows, trigger runs, monitor executions, interact with agents, manage skills and artifacts, connect MCP servers, and search documentation using natural language.
What Can It Do?
- List and manage saved flows and workbooks in your account
- Trigger flow runs with optional input parameters
- Monitor run status and retrieve detailed execution results
- Create, configure, and manage agents with full lifecycle control
- Run agent sessions and send follow-up messages conversationally
- Manage skills by creating, updating, downloading, and deleting skill packs
- Access agent artifacts produced during sessions
- List teams (workspaces) you belong to
- Connect and interact with MCP servers including listing tools, calling tools, reading resources, and using prompts
- Search documentation and get AI-powered answers
- Access audit logs for organization-level activity tracking
Where to Use It
In Agents (Recommended)
Add Gumloop as a tool to any agent. The agent can then manage your automations conversationally, choosing the right actions based on context.
To add an MCP tool to your agent:
- Open your agent’s configuration
- Click Add tools → Connect an app with MCP
- Search for the integration and select it
- Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.
In Workflows (Via Agent Node)
For automated pipelines, use an Agent Node with Gumloop tools. This gives you the flexibility of an agent within a deterministic workflow.
As a Custom MCP Node
You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
- Go to your node library and search for the integration
- Click Create a node with AI
- Describe the specific action you want (e.g., “Start my daily report flow”)
- Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.
Workflow Management
| Tool | Description |
|---|
| List Saved Flows | List saved flows/items in your account for a specific user or project |
| List Workbooks | List workbooks and their associated saved flows with nested flow information |
| Start Flow Run | Trigger a flow execution with optional input parameters |
| Get Run Details | Retrieve detailed flow run information including state, outputs, logs, and timestamps |
| Get Run History | Retrieve automation run history for workbooks or saved items with execution details |
Agent Management
| Tool | Description |
|---|
| List Agents | List agents in your account, with optional search and workspace filtering |
| Get Agent | Fetch a single agent’s configuration by its ID |
| Create Agent | Create a new agent with a name, model, and optional configuration |
| Update Agent | Update an existing agent’s metadata or configuration |
| List Models | List the model groups available to agents |
Agent Sessions
| Tool | Description |
|---|
| Start Agent | Send a message to a Gumloop agent and start an asynchronous interaction |
| Get Agent Status | Poll the status of an agent interaction and retrieve the agent’s response when completed |
| Create Agent Session | Start a session on an agent and return the completed response |
| Get Session | Fetch the state and result of an agent session by ID |
| Send Session Message | Send a follow-up message to an existing agent session and return the completed response |
| Cancel Session | Cancel an in-progress agent session |
Skills
| Tool | Description |
|---|
| List Skills | List skills in your account, with optional search, filtering, and pagination |
| Create Skill | Create a skill from one or more files stored in your workspace |
| Update Skill | Replace a skill’s files with files stored in your workspace |
| Delete Skill | Delete a skill from your account |
| Download Skill | Get a download URL for a skill archive |
Artifacts
| Tool | Description |
|---|
| List Agent Artifacts | List the artifacts an agent has produced, with optional session filtering and pagination |
| Download Artifact | Get a download URL for an agent artifact |
Teams
| Tool | Description |
|---|
| List Teams | List the teams (workspaces) the authenticated user belongs to |
MCP Server Management
| Tool | Description |
|---|
| List MCP Servers | List the MCP servers connected to your account |
| Get MCP Server | Fetch a single connected MCP server’s configuration by ID |
| List MCP Server Tools | List the tools exposed by a connected MCP server |
| Call MCP Tool | Execute a single tool on a connected MCP server |
| List MCP Resources | List the resources exposed by a connected MCP server |
| Read MCP Resource | Read the contents of a resource from a connected MCP server by URI |
| List MCP Prompts | List the prompts exposed by a connected MCP server |
| Get MCP Prompt | Get a rendered prompt from a connected MCP server, with optional arguments |
Documentation & Admin
| Tool | Description |
|---|
| Search Documentation | Search Gumloop documentation using semantic and keyword search with filtering options |
| Ask Gummie | Ask questions and get AI-powered answers from Gumloop documentation with citations |
| Get Audit Logs | Retrieve organization audit logs with event details and filtering by time period (admin only) |
Example Prompts
Use these with your agent or in the Agent Node:
List flows:
Show me all my saved flows
Start the "Daily Report" flow with input parameter date set to today
What's the status of my latest flow run?
Create a new agent called "Research Assistant" using the GPT-4o model
Start a session with my Research Assistant agent and ask "Summarize the latest quarterly report"
Send a follow-up message to my active session: "Can you break that down by region?"
List all skills in my account
Show me the artifacts from my last agent session and download the report
What MCP servers are connected to my account?
Use my connected Slack MCP server to send a message to #general
Search the Gumloop documentation for how to set up webhooks
How do I configure a Slack trigger for my workflow?
Show me the organization audit logs from the past week
Troubleshooting
| Issue | Solution |
|---|
| Agent not finding the right data | Specify flow names or project IDs explicitly |
| Action not completing | Check that you’ve authenticated with Gumloop |
| Unexpected results | The agent may chain multiple tools (e.g., listing flows first, then triggering a run). Review the agent’s reasoning to understand its approach. |
| Tool not available | Verify the tool is enabled in your agent’s MCP configuration |
Agents are smart enough to chain multiple API calls together. For example, asking “Run my latest flow and show me the results” will list flows, trigger a run, and poll for completion. If results seem off, check the agent’s step-by-step reasoning.
Need Help?
Use this integration directly in Claude or Cursor. Connect remotely via the Gumloop MCP server using your Gumloop credentials. 
