Racoons Docs
Guides

Using Racoons MCP Server

This document explains how to connect the Racoons MCP server to popular AI clients.

Introduction

Model Context Protocol (MCP) is a standardized way for AI applications like ChatGPT, Claude, and Cursor to interact with web apps like Racoons.

By connecting to Racoons's MCP server, you can retrieve your analyses and make changes to your website based on them using any AI application or AI agents.

Quick setup

Claude Chat

  1. Open Claude Chat settings
  2. Click Connectors
  3. Click "Add a custom connector"
  4. Enter these details and click add
    • Name: Racoons
    • Remote MCP server URL: https://mcp.racoons.ai
  5. Click connect and complete the authentication flow to connect your Racoons account
  6. Start using natural language to understand your analyses

Claude Code

  1. Run claude mcp add --transport http racoons https://mcp.racoons.ai in your console
  2. Run claude and then type /mcp
  3. Select racoons and then authenticate
  4. Complete the authorization flow
  5. Start using natural language to understand your analyses

Other AI Applications

Most AI applications that support MCP will have a similar setup process. Look for MCP or "Tools" settings and add the server URL: https://mcp.racoons.ai

Available capabilities

The Racoons MCP server provides these tools to AI applications:

  • projects - Get the organizations and project you belong to
  • list_analyses - List the analyses for a project with filters for time or type
  • fetch - Get a complete analysis by its id
  • search - Search for analyses by keywords within a project using full-text search
  • search_chat_messages - Search for chat messages by keywords and semantic meaning within a project
  • list_chat_sessions - List chat sessions for a project ordered by updated_at with filters for time
  • get_chat_session - Get a complete chat session by its id including all messages in chronological order
  • event_count - Count events with filters (time range in Unix seconds, event type, URLs, referrers, UTM parameters)

Example Prompts

Here are some ways to interact with Racoons via an AI client:

Simple usage examples

Get your last analysis

Get me my last analysis for my <Project name> project.

Get your projects

Get all my projects and their goals.

Get analyses within a certain timeframe

Get all my analyses this month in the <Project name> project.

Search for analyses by keyword

Search for analyses containing "checkout" in my <Project name> project.

Get your recent chat sessions

Get my last 5 chat sessions for my <Project name> project.

View a specific chat conversation

Show me the chat session with id <session-id>.

Search for chat messages

Search for chat messages containing "pricing" in my <Project name> project.

Complex usage examples

Complex workflows

Get my last landing page analysis and make changes to my website based on that.

Act on previous conversations

Look at my last AI conversation and make changes to my website based on what we discussed.

Summarize

Get my last 5 analyses and summarize what are the most relevant things I should work on.

Search and act

Search for all analyses mentioning "conversion rate" in my <Project name> project and summarize the key findings.

Count events

How many events have there been in the last month on /dashboard?

How many people clicked on the pricing page from the Google Ads campaign?

On this page