MCP Server - Gumloop

Gumloop exposes a remote Model Context Protocol (MCP) server that lets any compatible AI client manage your agents, sessions, skills, and more. Connect to the Gumloop MCP server natively in Claude, Cursor, and other clients, or use mcp-remote for clients that don’t yet support remote MCP.

https://mcp.gumloop.com/gumloop/mcp

You’ll need a Gumloop API key. Get one from the Gumloop API Key connector. The server handles OAuth automatically: you’ll be prompted to sign in and authorize access the first time you connect.

Setup

Claude

Navigate to Settings > Connectors and add a new MCP integration with the URL:

https://mcp.gumloop.com/gumloop/mcp

Cursor

Open Cursor Settings (Cmd/Ctrl + Shift + J)
Go to MCP and click Add new MCP server
Select Type: SSE and enter the server URL:

https://mcp.gumloop.com/gumloop/mcp

VS Code

Add the following to your .vscode/mcp.json:

{
  "mcpServers": {
    "gumloop": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.gumloop.com/gumloop/mcp"]
    }
  }
}

Windsurf

Open Windsurf settings (Cmd/Ctrl + ,)
Scroll to Cascade > MCP servers
Select Add Server > Add custom server
Add:

{
  "mcpServers": {
    "gumloop": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.gumloop.com/gumloop/mcp"]
    }
  }
}

Gumloop CLI

You can also explore and call tools from your terminal:

gumloop mcp list                                    # List connected servers
gumloop mcp tools gumloop                           # Browse available tools
gumloop mcp call gumloop list_agents --args-json '{}' # Call a tool

See the CLI MCP docs for the full reference.

Available Tools

The Gumloop MCP server exposes 46 tools across these categories:

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 (including `skill_ids` to attach skills)
`update_agent`	Update an existing agent’s metadata or configuration
`attach_agent_skills`	Attach one or more existing skills to a Gumloop agent
`detach_agent_skills`	Detach one or more skills from a Gumloop agent
`attach_agent_mcp_server`	Attach an MCP server (connector) to an agent, or update its configuration if already attached
`detach_agent_mcp_server`	Detach an MCP server (connector) from an agent
`list_models`	List the model groups available to agents
`list_agent_versions`	List the immutable versions of an agent
`get_agent_version`	Fetch an immutable agent version and its configuration

Agent Sessions

Tool	Description
`start_agent`	Send a message to an agent and start an asynchronous interaction
`get_agent_status`	Poll the status of an agent interaction and retrieve the 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 session and return the completed response
`cancel_session`	Cancel an in-progress agent session
`rename_session`	Rename an agent session (chat)
`list_agent_sessions`	List an agent’s sessions, with search, filters, sort, and pagination

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

Company Brain

Tool	Description
`search_brain`	Search your Company Brain’s indexed knowledge sources for relevant content

Documentation

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

Audit Logs

Tool	Description
`get_audit_logs`	Retrieve organization audit logs with event details and filtering by time period (admin only)

Audit logs are available over MCP as well as the REST API. The tool takes an organization_id, your user_id, a start_time/end_time window, and an optional max_limit (pagination is handled for you). Server-side filters beyond the time window — by event type, user, IP address, workspace, or entity — are REST-only. Only organization Admins can read audit logs, over MCP or REST.

Data Exports

Tool	Description
`export_data`	Create an organization data export for workflows, agents, agent interactions, credit logs, or Gumstack usage over a date range (admin only)
`get_export_status`	Poll an export’s status and get a signed download URL for the completed CSV

Use these two together to pull your organization’s agent and usage data into an MCP client: call export_data with a data_type (workflows, agents, agent_interactions, credit_logs, or gumstack), a date range, and the columns you want, then poll get_export_status with the returned data_export_id until it reports COMPLETED and request the download URL. Audit log exports aren’t one of the MCP data_type options — read audit events with get_audit_logs, or set up an audit log data drain.

The aggregated charts on the Organization Insights dashboard (overview totals, model usage, leaderboards, skill adoption, artifact analytics) aren’t available over MCP or the REST API. Use data exports for the underlying rows.

Flows & Runs

Tool	Description
`list_saved_flows`	List saved flows/items in your account for a user or project
`list_workbooks`	List workbooks and the saved flows they contain
`start_flow_run`	Start a flow run, with optional inputs for its Input nodes
`get_run_details`	Retrieve a flow run’s state, outputs, and logs
`get_run_history`	Retrieve the 10 most recent runs for a workbook or saved item

MCP vs. the REST API

The MCP server and the REST API overlap heavily, but neither is a strict superset of the other.

Surface	MCP	REST API
Agents, versions, skills, artifacts, model groups	Yes	Yes
Agent sessions (start, poll, follow up, cancel)	Yes	Yes
Connected MCP servers (list, inspect, call tools)	Yes	Yes
Flows, workbooks, and runs	Yes	Yes
Company Brain search	Yes	Yes
Audit logs	Yes (`get_audit_logs`, time range only)	Yes (`GET /get_audit_logs`, with event/user/IP/workspace filters)
Organization data exports	Yes (`export_data`, `get_export_status`)	Yes
Gumloop documentation search	Yes (`search_documentation`, `ask_gummie`)	No
Evaluations	No	Yes
Session approvals and queued messages	No	Yes
Workspace file upload and download	No	Yes
Workspace/role membership and role credit limits	No	Yes
Chat completions (OpenAI-compatible)	No	Yes

In short: use MCP when an AI client should drive Gumloop (agent management, sessions, skills, flows, Brain, audit logs, exports, and docs search), and the REST API when you need the full administrative surface — evaluations, approvals, file operations, and organization membership and credit administration.

Example Prompts

Once connected, try these with your AI client:

Create a new agent called "Research Assistant" using the GPT-4o model

Start a session with my Research Assistant agent and ask it to summarize the latest quarterly report

What MCP servers are connected to my account?

Search my Company Brain for our refund policy and summarize what it says

Export my organization's agent interactions for the last 30 days and tell me when the CSV is ready

Pull our audit logs for the last 7 days and summarize the credential_retrieval events

Gumloop MCP Integration

Full tool reference and usage examples.

API Reference

Programmatically manage MCP servers and call tools via the REST API.

CLI Reference

Explore and call MCP tools from your terminal.

Custom MCP Servers

Connect your own MCP servers to Gumloop.

Audit Logging

Tracked events, log structure, and admin access requirements.

Need Help?

Agents documentation for using MCP tools with agents
Need help? Reach out to us
Browse our Knowledge Base for common questions

​Setup

​Claude

​Cursor

​VS Code

​Windsurf

​Gumloop CLI

​Available Tools

​Agent Management

​Agent Sessions

​Skills

​Artifacts

​Teams

​MCP Server Management

​Company Brain

​Documentation

​Audit Logs

​Data Exports

​Flows & Runs

​MCP vs. the REST API

​Example Prompts

​Related Resources

Gumloop MCP Integration

API Reference

CLI Reference

Custom MCP Servers

Audit Logging

​Need Help?

Setup

Claude

Cursor

VS Code

Windsurf

Gumloop CLI

Available Tools

Agent Management

Agent Sessions

Skills

Artifacts

Teams

MCP Server Management

Company Brain

Documentation

Audit Logs

Data Exports

Flows & Runs

MCP vs. the REST API

Example Prompts

Related Resources

Need Help?