Skip to article

How to Call a Gumloop AI Agent From Claude Through MCP

Connect Claude to Gumloop, then give it one instruction that runs a single AI agent and bars edits and approval answers. You answer in Gumloop.

By Jacqueline V. TwillieNovember 10, 20266 min readGuide
Quick answer

Connect Claude to Gumloop as a custom connector, then give Claude one instruction. It starts a session with one named Gumloop AI agent, sends a short brief and returns the reply as written. The instruction bars Claude from creating, editing or deleting any AI agent and from answering an approval, which stays with you in Gumloop.

Type this into Claude: "Ask my Gumloop AI agent called [AI AGENT NAME] to read the notes below and send me its reply as written." Claude starts a session with that one AI agent and gets its reply.

Each request carries a short brief: the task, the text it needs, and what to send back. MCP is the connection Claude uses to reach Gumloop's tools.

What else can Claude do with the same connection?

Gumloop's setup page says your personal key also lets Claude run and edit AI agents in the teams you belong to, and the session tools include one that answers a paused session's approvals.

The block below tells Claude which Gumloop tools it may use. It's an instruction to Claude and not a lock. You answer approvals in Gumloop, where the Tasks page has an Approval Required filter that lists them. To see where a person fits into an AI agent's work, read What Does Human in the Loop Mean for an AI Agent?.

How do you call a Gumloop AI agent from Claude, step by step?

  1. 01

    Pick one AI agent you've tried by hand and read its approval icons.

    Open Gumloop, choose an AI agent whose single job you've already run yourself, and click the approval icon beside each connector in its Connectors list. Always allow, the default, lets the AI agent use all of that connector's tools without asking. Ask for writes/deletes lets reads run and stops writes, deletes and unknown-risk calls at an approval card. Set it on anything that sends or writes. Checked on 2026-11-11 against the approval modes table of Gumloop's Human in the loop page.

  2. 02

    Turn off Edit Own Instructions before Claude starts a session.

    On the tab named Agent, Edit Own Instructions is the toggle under the model picker and the instructions box. Turn it off, press Save and copy the instructions into your own notes. With it on, Gumloop's builder page lets a chat ask an AI agent to change its own configuration, behind an approval card. The session tools page calls a session a chat and lists the tool that answers approvals. The documentation doesn't say whether a configuration card appears in that list. Checked on 2026-11-10 against the self-improving instructions section of Gumloop's AI agent builder page and the session tools page.

  3. 03

    Connect Claude to Gumloop as a custom connector.

    In Gumloop, open Settings at the bottom of the left sidebar, then Profile, and find the Gumloop API key row. Generate a key there if you don't have one. In Claude, open Settings, choose Connectors under Customize, click Add, then Add custom connector. Name it Gumloop, paste the server address printed on the setup page and click Continue. If Claude doesn't open the sign-in page, click Connect beside Gumloop. On the Authorize Claude screen, keep Team set to Personal, check that Gumloop API Key shows Connected, and click Allow. A personal key reaches AI agents in every team you belong to, so name the team in a request if yours lives in one. Checked on 2026-11-10 against Gumloop's Connect a client page and the MCP troubleshooting page.

  4. 04

    Send a brief on a task whose answer you already know.

    Paste the block below, with the blanks written in, as the first message of the Claude chat where you'll make the call, and it stands for that whole chat. Then ask Claude to list your Gumloop AI agents, as the setup page suggests, and send a brief. The session tools list an AI agent and a message as their required inputs, so put the task, the text it needs in full and what to send back in that message. The comparison page gives the MCP server a No for session file upload. Ask Claude what it may and may not do with that AI agent, and read the answer against the block. Checked on 2026-11-11 against the session tools on Gumloop's session tools page, the tool names on Gumloop's AI agent tools page, the list prompt on Gumloop's Connect a client page and Gumloop's MCP vs. REST API page.

I am an ambassador for Gumloop. Code VIBE20 takes 20% off your first month.

What do you paste into Claude before it calls a Gumloop AI agent?

Copy and fill in
My Gumloop AI agent is [AI AGENT NAME]. If it lives in a team, the team is [TEAM NAME].
When I ask you to use it, list my Gumloop AI agents to find it, start a session with it and send one message. Each message is a brief with three parts: the task in a sentence or two, every piece of text it needs pasted in full into the message, and what I want sent back.
Return its reply exactly as it came back, with the name of the AI agent that wrote it. If the session ends without a reply, say so. Send a follow-up about the same work to the same session.
You may list AI agents and start, read and message sessions.
Use no other Gumloop tool: not create_agent, update_agent, delete_agent or update_agent_abilities, and not any attach, detach or trigger tool. Don't ask the AI agent to change itself.
If a session pauses for an approval, don't answer it and don't call resolve_session_approvals. Tell me the session is waiting and stop. I'll answer in Gumloop.

Did the call change anything in Gumloop?

Open the AI agent you called and compare its instructions box with your notes from step 02, and read its Connectors list and Triggers tab for anything you didn't add. Then look for the session in that AI agent's Tasks. The documentation doesn't say where a session started this way is listed, so if it isn't there, ask Claude to list that AI agent's sessions. The Approval Required filter on the Tasks page shows any session Claude stopped on and left for you.

If the reply came back thin, check the brief first. Add the missing text and send it again before you touch the AI agent's instructions. Pick a route for each of your other apps with Which Route Should an AI Agent Take to Each of Your Apps?.

Frequently asked questions

Can Claude answer an approval card for me?

Your pasted block bars it, and tells Claude to report that a paused session is waiting and stop. You answer in Gumloop. The documentation describes no bar in the connection itself, and the session tools include one that answers approvals.

What if Claude can't find my AI agent?

Ask it to list your Gumloop AI agents, then give it the exact name. A personal key reaches AI agents in every team you belong to, so when yours lives in a team, name the team in the request.

Does the Gumloop AI agent see the rest of my Claude chat?

Gumloop's session tools list an AI agent and a message as their required inputs, and the documentation doesn't describe Claude's chat being shared with it. Put the text it needs in the brief, pasted in full.

More on Tools for Non-Technical Managers