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

# Integrate Agents with MCP

> Create an agent on Rippletide and integrate it into any MCP-compatible client in under 2 minutes

## Overview

You can easily create an agent using the Rippletide Platform and expose it as an MCP server, ready to be plugged into any MCP-compatible agent or client.

## Step 1: Build your Agent

Go to the [Rippletide Builder](https://app.rippletide.com) and define your agent's:

* **Knowledge**: the data and context your agent can access
* **Processes**: the workflows and actions it can perform
* **Guardrails**: the safety rules and constraints it must follow

## Step 2: Visualize and Test

Navigate to the **Knowledge** tab to visualize your agent's context graph and test it interactively before going live.

## Step 3: Add to your Agent

Go to the **Launch** page. You will see **MCP Tools** and the exposed tools for your agent.

Copy the configuration for your favorite MCP-compatible client:

<AccordionGroup>
  <Accordion title="Claude Desktop" icon="message-bot">
    Add the following to your `claude_desktop_config.json` file:

    * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
    * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

    ```json theme={null}
    {
      "mcpServers": {
        "rippletide": {
          "type": "http",
          "url": "https://mcp.rippletide.com/mcp?agentId=<your-agent-id>"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Claude Code (CLI)" icon="terminal">
    Run the following command in your terminal:

    ```bash theme={null}
    claude mcp add rippletide --transport http "https://mcp.rippletide.com/mcp?agentId=<your-agent-id>"
    ```

    Or add it to your `.claude/settings.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "rippletide": {
          "type": "http",
          "url": "https://mcp.rippletide.com/mcp?agentId=<your-agent-id>"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Cursor" icon="code">
    Add the following to your `.cursor/mcp.json` file at the root of your project (or globally in `~/.cursor/mcp.json`):

    ```json theme={null}
    {
      "mcpServers": {
        "rippletide": {
          "type": "http",
          "url": "https://mcp.rippletide.com/mcp?agentId=<your-agent-id>"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Windsurf" icon="wind">
    Add the following to your `~/.codeium/windsurf/mcp_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "rippletide": {
          "type": "http",
          "url": "https://mcp.rippletide.com/mcp?agentId=<your-agent-id>"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="VS Code (GitHub Copilot)" icon="window">
    Add the following to your `.vscode/mcp.json` file at the root of your project:

    ```json theme={null}
    {
      "servers": {
        "rippletide": {
          "type": "http",
          "url": "https://mcp.rippletide.com/mcp?agentId=<your-agent-id>"
        }
      }
    }
    ```

    Or add it to your VS Code `settings.json` under `mcp`:

    ```json theme={null}
    {
      "mcp": {
        "servers": {
          "rippletide": {
            "type": "http",
            "url": "https://mcp.rippletide.com/mcp?agentId=<your-agent-id>"
          }
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Custom Agent / SDK" icon="robot">
    Use any MCP-compatible SDK or framework. Point your MCP client to the following URL:

    ```
    https://mcp.rippletide.com/mcp?agentId=<your-agent-id>
    ```

    The server supports **Streamable HTTP** transport.
  </Accordion>
</AccordionGroup>

That's it. In under 2 minutes you've created an agent on Rippletide, tested it, and integrated it into your agent using MCP.