RAGStack MCP Server

Official

Search and chat with a RAGStack knowledge base through its MCP server, with tools for document uploads and website ingestion.

Local serverstdioPython

What is the RAGStack MCP Server?

The RAGStack MCP server connects an assistant to a configured RAGStack knowledge base. It supports document search, chat with source citations, uploads and website-ingestion jobs. The Python package is ragstack-mcp, separate from deploying the RAGStack application itself.

Search before expanding the knowledge base

Ask a focused question and inspect the returned sources. Keep document identifiers or citations with the answer so another reader can check the underlying material. Upload and scrape tools add content to the knowledge base; identify the destination and source URLs before requesting ingestion.

Configure the existing deployment

Run uvx ragstack-mcp and set RAGSTACK_GRAPHQL_ENDPOINT and RAGSTACK_API_KEY from the RAGStack dashboard. The MCP client connects to that deployment rather than creating an AWS application automatically. Scrape jobs have their own status and scope controls, so starting a job should be followed by checking its result.

Setup and tool documentation. Explore related MCP servers.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_knowledge_baseSearch indexed knowledge-base content.
chat_with_knowledge_baseAsk a question and receive an answer with source citations.
start_scrape_jobStart website ingestion with the requested scope.
get_scrape_job_statusInspect a scrape job’s status.

How to install the RAGStack MCP Server

{
  "mcpServers": {
    "ragstack-kb": {
      "command": "uvx",
      "args": [
        "ragstack-mcp"
      ],
      "env": {
        "RAGSTACK_GRAPHQL_ENDPOINT": "https://YOUR_DEPLOYMENT.appsync-api.YOUR_REGION.amazonaws.com/graphql",
        "RAGSTACK_API_KEY": "YOUR_RAGSTACK_API_KEY"
      }
    }
  }
}

Replace both placeholders with the endpoint and API key from your RAGStack deployment.

Configuration

Python and uv for uvx, plus an existing RAGStack GraphQL endpoint and API key from the deployment dashboard.

VariableDescriptionRequired
RAGSTACK_GRAPHQL_ENDPOINTGraphQL endpoint for the intended RAGStack deployment.Yes
RAGSTACK_API_KEYAPI key from the deployment’s dashboard.Yes

Example prompts to try

  • “Search the knowledge base for our authentication guide and include the matching sources.”

Frequently asked questions

The maintained documentation uses ragstack-mcp, launched with uvx ragstack-mcp.