MCP Server

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

Which MCP page do you need?

This section is about Raffle’s own MCP server: connecting AI assistants such as Claude, ChatGPT or Copilot to your Raffle knowledge.

To do the opposite, and connect your own MCP server so that Raffle’s chat can call its tools, add it as a source. See MCP server source.

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 exposes one search tool. It takes a query and returns the most relevant results from your knowledge base, each with its title, URL and content.

Argument	Required	Description
`query`	Yes	The search query
`max_results`	No	How many results to return. Default 5, maximum 20.
`surrounding_section_range`	No	How many sections before and after each result to include, for more context. Default 2, maximum 5.

The AI assistant fills in these arguments itself; you don’t need to set them.

Prerequisites

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

Anyone with the URL can search

Your MCP URL works like a public link: anyone who has it can search the content of that widget, just as visitors can on your website. Only connect widgets whose content may be read by everyone who gets the URL.

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

Open your API widget, go to the General tab, and scroll down to the MCP Configuration section. Enter your description in the Widget Description field. 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

Click Install on your API widget. The Install dialog shows the widget’s MCP URL, with a button to copy it. It is built from the UID of the widget:

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

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 widget description is clear, the assistant will automatically invoke the Raffle search tool and include the results in its response.