# MCP Catalog

The MCP Catalog is your gateway to 50+ pre-built integrations that can be deployed to DarcyIQ in minutes. Browse official and community integrations, configure your credentials, and start using powerful tools without writing any code.

{% hint style="success" %}
**Quick Setup**: Most catalog integrations can be deployed in under 5 minutes—just add your credentials and click deploy.
{% endhint %}

## Overview

<figure><img src="/files/9NkWGvE4ufDcLgheiVBO" alt=""><figcaption></figcaption></figure>

The MCP Catalog provides ready-to-use integrations from Docker Hub's MCP ecosystem. Each integration comes pre-built and tested, so you can focus on configuration rather than development.

| Feature                      | Description                                                       |
| ---------------------------- | ----------------------------------------------------------------- |
| **50+ Integrations**         | Growing library of pre-built MCPs                                 |
| **Official**                 | Verified official images with enterprise Docker security baked in |
| **Organization Recommended** | Your team's favorite integrations highlighted at the top          |
| **One-Click Setup**          | Create a deployment draft with a single click                     |
| **No Code Required**         | Just configure your credentials and deploy                        |

## Browsing the Catalog

### Accessing the MCP Catalog

{% stepper %}
{% step %}
**Open MCP Studio**

From the DarcyIQ sidebar, navigate to **MCP Studio**.
{% endstep %}

{% step %}
**Select MCP Catalog**

Click on the **MCP Catalog** tab to view available integrations.
{% endstep %}

{% step %}
**Browse or Search**

Use the search bar to find specific integrations, or browse by scrolling through the catalog.
{% endstep %}
{% endstepper %}

### Search and Sort Options

Find the right integration quickly:

| Option                  | Description                      |
| ----------------------- | -------------------------------- |
| **Search**              | Filter by name or description    |
| **Sort by Downloads**   | Most popular integrations first  |
| **Sort by Stars**       | Highest-rated integrations first |
| **Sort by Latest**      | Newest additions to the catalog  |
| **Sort Alphabetically** | A-Z listing                      |

## Understanding Integration Badges

Each integration displays badges that help you assess quality and trust:

| Badge          | Meaning                                     | What It Indicates                   |
| -------------- | ------------------------------------------- | ----------------------------------- |
| **Official**   | Published by Docker in the `mcp/` namespace | Verified, maintained, and supported |
| **SBOM**       | Software Bill of Materials available        | Transparent dependency information  |
| **Provenance** | Build provenance verified                   | Traceable build process             |
| **Signed**     | Cryptographically signed                    | Verified publisher identity         |

{% hint style="info" %}
**Recommendation**: Start with Official integrations when available. They receive regular updates and have verified security practices.
{% endhint %}

## Organization Recommended

Your organization can mark certain integrations as "recommended" to help team members find approved tools quickly.

| Feature                  | Description                                               |
| ------------------------ | --------------------------------------------------------- |
| **Highlighted Section**  | Recommended integrations appear at the top of the catalog |
| **Custom Display Names** | Admins can set friendly names for recommended MCPs        |
| **Team Alignment**       | Ensures everyone uses approved integrations               |

### Managing Recommendations (Admin)

If you have the `MCP BUILDER MANAGE` permission, you can:

1. Click the **star icon** on any integration to add it to recommendations
2. Set a custom display name for your organization
3. Remove integrations from recommendations by clicking the star again

## Setting Up a Catalog Integration

Follow these steps to deploy a pre-built integration:

{% stepper %}
{% step %}
**Find Your Integration**

Browse or search the MCP Catalog for the integration you need.
{% endstep %}

{% step %}
**Click "Set Up"**

Click the **Set Up** button on the integration card. This creates a draft MCP server pre-configured with the catalog code.
{% endstep %}

{% step %}
**Configure Secrets**

On the **Build** tab, scroll to the **Secrets** section. Enter the required credentials for the integration.

| Field Type    | Description                              | Example                            |
| ------------- | ---------------------------------------- | ---------------------------------- |
| **Required**  | Must be provided before deployment       | API Key, Database URL              |
| **Optional**  | Enhances functionality but not mandatory | Timeout settings, custom endpoints |
| {% endstep %} |                                          |                                    |

{% step %}
**Deploy**

Navigate to the **Deploy** tab and click **Deploy**. The deployment process will:

1. Build the container image
2. Deploy to secure infrastructure
3. Create the API endpoint

Watch the streaming progress to see each step complete.
{% endstep %}

{% step %}
**Enable for DarcyIQ**

On the **Connect** tab, toggle **Enable for Darcy** to make the integration available in Chat and Workflows.
{% endstep %}

{% step %}
**Start Using**

Return to DarcyIQ Chat or create a Workflow. Your new integration is now available as a tool!
{% endstep %}
{% endstepper %}

## Popular Catalog Categories

The MCP Catalog includes integrations across many categories:

### Communication & Collaboration

| Integration         | Description                     | Common Use Cases                    |
| ------------------- | ------------------------------- | ----------------------------------- |
| **Slack**           | Send messages and notifications | Alert teams, share updates          |
| **Microsoft Teams** | Teams messaging integration     | Team notifications, channel updates |
| **Email (SMTP)**    | Send emails programmatically    | Notifications, reports, alerts      |

### Databases

| Integration    | Description                | Common Use Cases          |
| -------------- | -------------------------- | ------------------------- |
| **PostgreSQL** | Query PostgreSQL databases | Data retrieval, reporting |
| **MySQL**      | MySQL database integration | Customer data, analytics  |
| **MongoDB**    | NoSQL document database    | Flexible data queries     |
| **Redis**      | In-memory data store       | Caching, session data     |

### Developer Tools

| Integration | Description                     | Common Use Cases              |
| ----------- | ------------------------------- | ----------------------------- |
| **GitHub**  | Repository and issue management | Code reviews, issue tracking  |
| **GitLab**  | GitLab integration              | CI/CD, project management     |
| **Jira**    | Issue and project tracking      | Sprint planning, bug tracking |

### Cloud Services

| Integration      | Description                     | Common Use Cases                  |
| ---------------- | ------------------------------- | --------------------------------- |
| **AWS**          | Amazon Web Services integration | Infrastructure queries, S3 access |
| **Google Cloud** | GCP service integration         | Cloud resources, BigQuery         |
| **Azure**        | Microsoft Azure services        | Azure resources, storage          |

### File & Document

| Integration      | Description               | Common Use Cases                    |
| ---------------- | ------------------------- | ----------------------------------- |
| **Google Drive** | Access Google Drive files | Document retrieval, file management |
| **Dropbox**      | Dropbox file integration  | File sharing, backup                |
| **Box**          | Box enterprise content    | Secure file access                  |

### CRM & Sales

| Integration    | Description                | Common Use Cases                |
| -------------- | -------------------------- | ------------------------------- |
| **Salesforce** | Salesforce CRM integration | Lead data, opportunity tracking |
| **HubSpot**    | HubSpot CRM and marketing  | Contact management, campaigns   |
| **Pipedrive**  | Sales pipeline management  | Deal tracking, contacts         |

## Secrets and Credentials

### Understanding Required Secrets

Each catalog integration specifies which credentials it needs:

| Secret Type                   | Description                   | Example                               |
| ----------------------------- | ----------------------------- | ------------------------------------- |
| **API Key**                   | Single key for authentication | `sk-abc123...`                        |
| **Username/Password**         | Basic authentication          | Database credentials                  |
| **OAuth Token (coming soon)** | Token-based authentication    | Service access tokens                 |
| **Connection String**         | Full connection details       | `postgresql://user:pass@host:5432/db` |

### Security Best Practices

{% hint style="warning" %}
**Security Notice**: Never share your API keys or credentials. MCP Studio stores secrets securely and never exposes them in code or logs.
{% endhint %}

| Practice                | Description                                      |
| ----------------------- | ------------------------------------------------ |
| **Use Dedicated Keys**  | Create API keys specifically for DarcyIQ         |
| **Minimum Permissions** | Grant only the permissions the integration needs |
| **Rotate Regularly**    | Update credentials periodically                  |
| **Monitor Usage**       | Check for unexpected activity                    |

## After Deployment

Once your catalog integration is deployed:

### Using in Chat

Your integration's tools are automatically available in DarcyIQ Chat. Simply ask the AI to use them:

* "Use Slack to send a message to the #general channel"
* "Query the PostgreSQL database for all customers from last month"
* "Create a new GitHub issue for this bug"

### Using in Workflows

1. Open the Workflow editor
2. Add a new step
3. Select your integration from the available tools
4. Configure the step parameters
5. Save the workflow

### Managing Your Integration

From the **My MCPs** tab, you can:

| Action        | Description                           |
| ------------- | ------------------------------------- |
| **Edit**      | Update secrets or configuration       |
| **Stop**      | Temporarily disable the integration   |
| **Share**     | Give team members access              |
| **Duplicate** | Create a copy with different settings |
| **Delete**    | Remove the integration entirely       |

## Troubleshooting Catalog Integrations

### Common Issues

| Issue                    | Cause                      | Solution                                            |
| ------------------------ | -------------------------- | --------------------------------------------------- |
| **Deployment fails**     | Missing required secrets   | Check the Build tab and fill in all required fields |
| **Authentication error** | Invalid credentials        | Verify your API key or credentials are correct      |
| **Connection timeout**   | Network or firewall issues | Ensure the external service is accessible           |
| **Tool not appearing**   | Integration not enabled    | Go to Connect tab and toggle "Enable for Darcy"     |

### Getting Help

If you encounter issues with a catalog integration:

1. Check the [Troubleshooting Guide](/integrations-and-configuration/mcp-studio/troubleshooting.md) for common solutions
2. Review the integration's documentation on Docker Hub
3. Contact DarcyIQ support for additional assistance

## Next Steps

| Goal                           | Documentation                                                                              |
| ------------------------------ | ------------------------------------------------------------------------------------------ |
| Build a custom integration     | [Building Custom MCPs](/integrations-and-configuration/mcp-studio/building-custom-mcps.md) |
| Learn about deployment options | [Deploying & Managing](/integrations-and-configuration/mcp-studio/deploying-mcps.md)       |
| View code examples             | [Code Samples](/integrations-and-configuration/mcp-studio/mcp-studio-samples.md)           |
| Troubleshoot issues            | [Troubleshooting](/integrations-and-configuration/mcp-studio/troubleshooting.md)           |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.darcyiq.com/integrations-and-configuration/mcp-studio/mcp-catalog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
