> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minoa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Gumloop

> Connect Gumloop agents and flows to Minoa via MCP

## Overview

Connect **Gumloop** to your **Minoa** workspace so your Gumloop agents can work with live sales data: business cases, pipeline analytics, your value framework, and the deal documents behind them.

Minoa is a **custom MCP server** in Gumloop's terms, meaning a server you point Gumloop at by URL. You add it once on the Connectors page, then attach it to any agent that needs it.

## What you can do

| Scenario | Description |
| - | - |
| **Deal research agent** | Have an agent pull a business case, summarize the value story, and post it to Slack |
| **Pipeline digest** | Run a scheduled flow that reads pipeline analytics and writes a weekly recap |
| **Business case kickoff** | Create a business case with AI-recommended use cases the moment a deal reaches a stage |
| **Enrichment loop** | Combine Minoa's win drivers with the rest of your Gumloop stack to prioritize accounts |

***

## Before you start

* A Gumloop account
* A Minoa account

You don't need a client ID or secret. Gumloop registers itself with Minoa automatically during the OAuth flow.

***

## Connect Minoa

### Step 1: Add Minoa as a custom MCP connector

1. In Gumloop, select **Customize** in the left sidebar, then open the **Connectors** tab.

2. Click the **+** button in the top-right corner (**Add Custom MCP** on wider screens). The **Connect MCP Server** dialog opens.

3. In **MCP Server URL**, enter:

   ```
   https://mcp.minoa.io
   ```

4. Click **Connect**.

> [!NOTE]
>
> On an organization account with a Managed Tunnel available, Gumloop first asks for a **Connection type**. Minoa is a
> public HTTPS server, so choose **Public URL**.

### Step 2: Authenticate with your Minoa account

Gumloop probes the server and shows **Detected Auth**. Minoa uses OAuth, so Gumloop shows **OAuth**.

1. Click **Authenticate**.
2. Sign in to Minoa with your own account.
3. Review the permissions and authorize.

> [!TIP]
>
> **Why personal sign-in?**
>
> Each person connects with their own credentials rather than a shared account. Your agents inherit your Minoa role, so
> they can read and change exactly what you can in the web app and nothing else, and every action is attributed to you
> rather than to an anonymous service account.

> [!NOTE]
>
> Minoa enforces the same permissions over MCP as it does in the web app, so editing the value framework and its math
> stays admin-only. See [Permissions and governance](https://docs.minoa.io/pages/integrations/mcp.md#permissions-and-governance).

### Step 3: Add Minoa to an agent

1. Open the agent you want to use Minoa, and find the **Connectors** section.
2. Click **+ Add**, search for your Minoa server under **Search connectors**, and click **+** next to it.
3. Click **Save**.

The agent discovers Minoa's tools on its own and picks the right ones from the conversation. You don't wire up tools by hand.

### Step 4: Try it out

Ask the agent:

> "What business cases do I have open right now?"

If it comes back with your real deals, you're connected.

***

## Example prompts

### Browse business cases

* "Show me all my open business cases"
* "Find business cases for Acme"
* "Show me the full ROI breakdown for the Snowflake deal"

### Check your pipeline

* "How's my pipeline doing this quarter?"
* "What's my win rate on enterprise deals?"
* "Which use cases have the highest win rate?"

### Prepare for a call

* "I have a call with Notion tomorrow, build me a discovery brief"
* "What has won in accounts that look like Stripe?"

### Create a business case

* "Create a business case for Stripe, enterprise fintech"
* "Set up a BC for a mid-market healthcare company called MedTech"

***

## Commonly used tools

Your agent lists everything available to your account. These are the ones most Gumloop builds reach for.

| Tool | Description |
| - | - |
| `minoa_list_business_cases` | Search and list business cases by name or status |
| `minoa_get_business_case` | Full details and computed totals for a business case |
| `minoa_get_pipeline_analytics` | Pipeline metrics, win rates, and trends |
| `minoa_get_use_case_analytics` | Use case effectiveness and win rates |
| `minoa_get_deal_win_drivers` | What has won in comparable deals, drawn from your closed business |
| `minoa_prepare_for_sales_call` | Build a pre-call discovery brief for an upcoming meeting |
| `minoa_create_smart_business_case` | Create a business case with AI-recommended use cases |

For the complete set, including the build, publish, and export capabilities, see the [Minoa MCP Server](https://docs.minoa.io/pages/integrations/mcp.md#available-tools) page.

***

## Manage access

A custom MCP connector is personal. If you share an agent, teammates add Minoa themselves and sign in with their own account, so nobody inherits your access. Manage or remove your connection under **Customize** → **Connectors**.

An agent can run unattended under whoever's connection it holds, and everything it does is logged under that person.

> [!WARNING]
>
> Connect agents that run on a schedule with a non-admin account unless the agent genuinely needs admin reach. Admin
> access is what allows value framework edits.

> [!TIP]
>
> On an organization plan, an admin can register Minoa once as a **proxied MCP** under **Settings** → **Connectors &
> MCP** → **Proxied MCPs**, which adds Gumloop-side activity logs and tool access control. Because Minoa uses OAuth,
> each person still signs in with their own account, so the permission model above is unchanged.

Gumloop agents see the same permission-checked toolset as every other MCP client. The full capability list, and the role each one requires, is on the [Minoa MCP Server](https://docs.minoa.io/pages/integrations/mcp.md#available-tools) page.

***

## Troubleshooting

> [accordion] "Invalid redirect\_uri" when you click Authenticate
>
> Minoa only accepts sign-in redirects from clients it has reviewed, and Gumloop's OAuth callback is served from
> `https://api.gumstack.com/auth/callback`, not a `gumloop.com` address.
>
> That callback is on Minoa's allowlist, so a current Gumloop account works. If you still hit this, email
> [support@minoa.io](mailto:support@minoa.io) with the full error, including the redirect URL it names.

> [accordion] Gumloop can't detect the auth method
>
> Check the server URL is exactly `https://mcp.minoa.io`, with no trailing path. Gumloop reads Minoa's OAuth
> metadata from `https://mcp.minoa.io/.well-known/oauth-authorization-server`, so a wrong URL leaves it with
> nothing to detect.

> [accordion] No tools appear after you authenticate
>
> Make sure Minoa is added under the agent's **Connectors** section and that you clicked **Save**. Connecting the
> server on the Connectors page doesn't attach it to an agent on its own.

> [accordion] Tools suddenly stop working ("can't access" errors)
>
> Your authorization has expired and Gumloop isn't prompting you to reconnect. Remove the Minoa connector under
> **Customize** → **Connectors**, add it again, and sign in. See
> [Token lifetimes](https://docs.minoa.io/pages/integrations/mcp.md#token-lifetimes) for how long an authorization lasts.

***

## Need help

For anything else, reach out to [support@minoa.io](mailto:support@minoa.io).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.