> ## 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.

# Dust

> Connect Dust agents to Minoa for AI-powered sales intelligence

## Overview

Connect **Dust** to your **Minoa** workspace and supercharge your AI agents with real-time sales data. Once connected, your Dust agents can query your pipeline, analyze use case performance, and even create business cases — all through natural conversation.

<Warning>
  This integration is currently in **beta**. Reach out to [support@minoa.io](mailto:support@minoa.io) to get access.
</Warning>

## What Can I Do With This?

Once connected, your Dust agents can help you with:

| What You Want             | What to Ask                                                         |
| ------------------------- | ------------------------------------------------------------------- |
| **See your deals**        | "Show me my open business cases"                                    |
| **Check pipeline health** | "How's my pipeline doing this quarter?"                             |
| **Find what's working**   | "Which use cases have the highest win rate?"                        |
| **Prep for a meeting**    | "Create a business case for Acme Corp — they're enterprise fintech" |
| **Get deal details**      | "Show me the Snowflake business case"                               |

***

## Getting Started

You'll need **Admin access** to your Dust workspace to add the Minoa integration.

### Step 1: Add the MCP Server

1. In Dust, navigate to **Spaces > Tools** in the sidebar
2. Click **+ Add Tools**
3. Select **MCP Server** from the available options
4. Enter `https://mcp.minoa.io`
5. Leave **Authentication** set to **Automatic** — Dust will detect OAuth automatically

### Step 2: Choose Authentication Mode

After entering the URL, you'll be asked how you want to connect:

| Mode                  | Description                                               | Best For                                                               |
| --------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------- |
| **Personal accounts** | Each team member logs in with their own Minoa credentials | Most teams — provides audit trails and respects individual permissions |
| **Shared account**    | All agents use a single set of credentials you provide    | Service accounts or workspace-wide bots                                |

<Tip>
  **We recommend Personal accounts** for most use cases. This ensures every action your Dust agents take is logged under the right user, and agents can only access data that user is allowed to see.
</Tip>

### Step 3: Authorize Access

1. After adding the server, click **Connect**
2. You'll be redirected to Minoa to sign in
3. Review the permissions and click **Authorize**
4. You'll be redirected back to Dust

Once authorized, the Minoa tools will appear in your workspace's Tools list.

### Step 4: Add Minoa Tools to Your Agent

Now you can add Minoa capabilities to any Dust agent:

1. Open the agent you want to enhance (or create a new one)
2. Go to the **Tools & Knowledge** section
3. Find **Minoa** in the available tools and enable it
4. Save your agent

<Check>Your Dust agent can now access your Minoa data!</Check>

***

## Try It Out

Open a conversation with your Minoa-enabled agent and ask:

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

If the agent responds with your actual deals, you're all set.

***

## Things Your Agent Can Do

### Browse Business Cases

* "Show me all my open business cases"
* "Find business cases for Acme"
* "List my won deals"

### Check Your Pipeline

* "How's my pipeline doing?"
* "What's my win rate this quarter?"
* "Show me pipeline trends for the last 90 days"

### Find What's Working

* "Which use cases have the highest win rate?"
* "What should I be leading with in enterprise deals?"
* "Show me our top performing value drivers"

### Get Deal Details

* "Show me the full business case for Snowflake"
* "What's the value story for the Stripe deal?"
* "Pull up the ROI breakdown for Acme"

### Explore Your Value Framework

* "What use cases do we have?"
* "Show me our ROI calculations"
* "What value drivers can I use?"

### Create a Business Case

* "Create a business case for Stripe — enterprise fintech"
* "Set up a BC for a mid-market healthcare company called MedTech"
* "I have a call with Notion tomorrow — build me a business case"

When you ask an agent to create a business case, it will:

1. Find or create the account in Minoa
2. Analyze which use cases win in similar deals
3. Add the best-fit use cases automatically
4. Generate an AI value hypothesis
5. Return a link to the new business case

***

## Managing Access

### Space-Based Restrictions

By default, Minoa tools are available to all users in your Dust workspace. To restrict access:

1. Click the **Sharing** tab on the Minoa tool
2. Enable **Restricted Access**
3. Select which spaces can use the tool

Only members of those spaces will be able to use Minoa capabilities.

### Disconnecting

To revoke Minoa access:

1. Navigate to **Spaces > Tools** in Dust
2. Find **Minoa** and click on it
3. Click **Remove** or **Disconnect**

If using personal credentials, each user can also revoke their own authorization from their Minoa account settings.

### Reconnecting Your Personal Credentials

If your agents suddenly can't access Minoa data (e.g. "unable to access the business case"), your personal authorization has likely expired. To reconnect — no admin needed:

1. Click your **Profile** (avatar, bottom-left) → **Profile** → **Tools & Triggers**
2. Find **Minoa** and click **Disconnect**
3. Use a Minoa tool in any conversation — Dust will prompt you to sign in to Minoa again

Dust renews its Minoa authorization automatically in the background, so this should rarely be necessary. At most every **90 days** you'll be asked to sign in again.

***

## Technical Reference

For power users and admins, here's what's available under the hood.

### Available Tools

| Tool                             | Description                                                                  |
| -------------------------------- | ---------------------------------------------------------------------------- |
| `list_business_cases`            | Search and list business cases by name or status                             |
| `get_business_case`              | Get full details of a specific business case                                 |
| `list_value_framework_use_cases` | List use cases from your value framework library (compact: IDs, names, tags) |
| `get_value_framework_use_case`   | Get full detail for a single value framework use case (calculations, inputs) |
| `get_value_hypothesis`           | Get the AI-generated value hypothesis for a deal                             |
| `get_pipeline_analytics`         | Pipeline metrics, win rates, and trends                                      |
| `get_use_case_analytics`         | Use case effectiveness and win rates                                         |
| `create_smart_business_case`     | Create a new business case with AI-recommended use cases                     |

### Available Resources

Dust agents can also read these resources directly:

| Resource         | Description                                           |
| ---------------- | ----------------------------------------------------- |
| Value Framework  | All active use cases with calculations and properties |
| Business Case    | Full details including scenarios and financials       |
| Value Hypothesis | AI-generated value narrative for a deal               |

### Security

* All requests are authenticated via OAuth and scoped to your Minoa workspace
* Personal credentials mode ensures agents only access data the user can see
* Your authorization can be revoked at any time from Dust or Minoa

***

## Need Help?

If you're having trouble connecting, try removing and re-adding the Minoa server in Dust.

For access or other questions, reach out to [support@minoa.io](mailto:support@minoa.io).