URL Reputation and Validity Checker

You run a FASTMCP 2.0–based service that validates URLs, assigns reputation scores, and helps you detect AI-generated or suspicious web links. It provides practical checks you can rely on to verify page authenticity, extract links, and analyze historical data for stronger URL trust decisions.

How to use

You interact with the URL Reputation and Validity Checker from an MCP client to perform common tasks. Check the reputation of multiple URLs at once, extract and assess links from HTML or text content, validate individual URLs, and retrieve historical data about domains.

How to install

Prerequisites you need installed on your system:

Python 3.8+ (or newer) and pip for Python dependencies.

Docker installation (recommended)

Clone the project and start the services with Docker Compose.

git clone <repository-url>
cd reputation-and-validity-checker
docker-compose up -d

Local installation without Docker

Install Python dependencies, start Redis for caching if you want it, then run the server.

pip install -r requirements.txt

# Optional: start Redis for caching
# docker run -d -p 6379:6379 redis:7-alpine

# Start the MCP server locally
python -m url_reputation_checker.server

Environment variables you may use

Default settings assume Redis is available at redis://localhost:6379 and the MCP server binds to 0.0.0.0:5000. You can override these with environment variables when running the server.

Configure environment variables

• REDIS_URL: Redis connection URL for caching (default: redis://localhost:6379).

• MCP_SERVER_HOST: Server host (default: 0.0.0.0).

• MCP_SERVER_PORT: Server port (default: 5000).

Usage examples

Use the MCP client to call available tools and obtain results for your URLs.

Summary of available MCP tools

• check_links_reputation: Check reputation for a list of URLs. Returns a list of results with reputation scores.

• extract_and_check_links: Extract links from content and check their reputation. Returns extracted links with validation results and a summary.

• validate_url: Validate a single URL and return detailed information.

• get_domain_history: Retrieve historical information about a domain, including WHOIS and Wayback data.

Notes on usage

The service can be run via Docker for easy deployment or locally with Python. If Redis is unavailable, caching is disabled but the service continues to operate. Historical data lookups may be rate-limited by external services and can be skipped if unavailable.

Available tools

check_links_reputation

Check reputation for a list of URLs and return a set of results with reputation scores

extract_and_check_links

Extract links from HTML or text content and check their reputation, returning extracted links with results and a summary

validate_url

Validate a single URL and return detailed validation information about its accessibility and characteristics

get_domain_history

Fetch historical data for a domain, including WHOIS information and Wayback Machine data