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
- Open Claude Chat settings
- Click Connectors
- Click "Add a custom connector"
- Enter these details and click add
- Name: Racoons
- Remote MCP server URL:
https://mcp.racoons.ai
- Click connect and complete the authentication flow to connect your Racoons account
- Start using natural language to understand your analyses
Claude Code
- Run
claude mcp add --transport http racoons https://mcp.racoons.aiin your console - Run
claudeand then type/mcp - Select
racoonsand then authenticate - Complete the authorization flow
- 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?