MCP Server

Connect your Raffle knowledge base to AI platforms like Claude, ChatGPT, MS Copilot, and OpenWebUI using the Model Context Protocol (MCP).

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants call external tools during a conversation. By connecting your Raffle knowledge base as an MCP server, AI platforms can search your content automatically when answering questions.

The Raffle MCP server currently exposes a search tool that accepts a query and returns the most relevant results from your knowledge base.

Prerequisites

You need an API tool set up in Raffle. The MCP server URL is tied to the UID of that tool.

Step 1 — Add a tool description

The tool description tells the AI when and why it should search your knowledge base. A clear, specific description leads to better, more targeted tool calls.

Navigate to your tool’s admin page by clicking the Admin button at the bottom of the page. Find the Tool description field and write a short description. For example:

Search [Company Name]'s product documentation, FAQs, and support articles. Use
this tool when answering questions about [product or topic], troubleshooting
issues, or looking up features and pricing.

Tips for a good description:

Name the content — product docs, HR policies, support articles, etc.
State when to use it — “when answering questions about X” or “for troubleshooting Y”
Keep it concise — one or two sentences is enough
Match the language — write the description in the same language as your knowledge base, so the AI generates queries in the right language

Step 2 — Find your MCP URL

Your MCP URL is built from the UID of your API tool:

https://mcp.raffle.ai/experimental/{UID}/mcp

Find the UID via the Go Live button on your tool’s admin page.

Step 3 — Connect your AI platform

Choose your platform below for setup instructions.

Claude.ai

For Pro, Max, Team, and Enterprise plans

ChatGPT

Using MCP apps in the ChatGPT desktop app

MS Copilot

Via the Copilot Studio MCP onboarding wizard

OpenWebUI

Via Admin Settings in Open WebUI v0.6.31+

Other clients

Any MCP-compatible client over HTTP

Verification

Once connected, ask your AI assistant a question that should be answered from your knowledge base. If the tool description is clear, the assistant will automatically invoke the Raffle search tool and include the results in its response.