Example Agentic Search MCP Server

An MCP server that enables AI agents to search and retrieve content from websites.

Prerequisites

• uv
• Python 3.13
• Node.js v22 - if you want to use MCP Inspector

Setup

Install dependencies:

uv sync

Testing with MCP Inspector

Set mcp_transport = "stdio" in main.py, then run:

mcp dev main.py

Usage

Specify target website

Change url_base and search_url_base in main.py. For example:

• url_base = "https://www.gov.uk"
• search_url_base = "https://www.gov.uk/search/all?keywords="

Running locally

uv run main.py

Remote Deployment

Set mcp_transport = "streamable-http" in main.py, then follow the user guide of your preferred compute/container platform.

Tools

• search(query) - Search the website and return search results as markdown
• get_page(path) - Retrieve webpage content as markdown