QAnon

This MCP (Model Context Protocol) server gives you access to a dataset of Q-Anon posts for research, enabling search, filtering, and analysis through compatible MCP clients. It streamlines data exploration and tooling for anthropological and sociological study of the posts.

How to use

You connect a compatible MCP client to the qanon_mcp server to search and analyze posts. Use the client’s standard MCP features to query posts by id, author, date range, or keywords, and to request analyses or timelines. When connected, you’ll see available tools such as retrieving a post by ID, performing keyword searches, and generating word clouds or timelines to understand trends in the data.

How to install

Prerequisites you need before installing this MCP server are: Python 3.10 or higher, the uv package manager, and Claude Desktop if you plan to integrate with Claude.

Option 1: Install via Smithery (automatic for Claude Desktop) You will run a single command to install the MCP server for Claude Desktop:
```bash
npx -y @smithery/cli install @jkingsman/qanon-mcp-server --client claude

Option 2: Manual installation (local setup) Complete the following steps on your machine:
1. Ensure you have Python 3.10+ installed.
2. Ensure you have the uv package manager installed.
3. Install the MCP server locally by running:
```bash
uv pip install -e .

4. Start the MCP server with the standard runtime (see usage) to verify it is reachable.

## Additional configuration and notes

Claude Desktop integration for this MCP server is provided via a JSON configuration. The server exposes two local runtime options you can use from Claude Desktop. Choose the approach that matches your environment:

Option A: Use uvx (recommended when uvx is installed)

{
  "mcpServers": {
    "qanon_mcp": {
      "command": "uvx",
      "args": [
        "qanon_mcp"
      ]
    }
  }
}

Option B: Use uv with the tool runner (uv and tool wrapper required)

{
  "mcpServers": {
    "qanon_mcp": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "qanon_mcp"
      ]
    }
  }
}

Troubleshooting and tips

If Claude Desktop does not show the hammer icon indicating tools are available, review your configuration and restart Claude Desktop. Ensure the posts.json data file (if referenced by your setup) is in the expected location, and verify that you are using absolute paths in the Claude Desktop configuration. Check terminal output for any error messages when starting the MCP server.

Resources and endpoints

The MCP server provides a set of resources and tools to access and analyze the Q-Anon post data. Use these resources and tools through your MCP client to retrieve posts, list authors, view statistics, and generate analyses and timelines.

Available tools

get_post_by_id_tool

Retrieve a specific post by its ID to inspect content, author, and metadata.

search_posts

Find posts containing specific keywords or phrases across the dataset.

get_posts_by_date

Retrieve posts within a specified date range to study temporal trends.

get_posts_by_author_id

Find posts authored by a particular author ID for author-level analysis.

analyze_post

Get a detailed analysis of a single post, including references and contextual notes.

get_timeline_summary

Generate a chronological timeline of posts, with optional date filtering.

word_cloud_by_post_ids

Create a word frequency visualization for posts within a specified ID range.

word_cloud_by_date_range

Create a word frequency visualization for posts within a date range.