home / mcp / ground truth mcp server

Ground Truth MCP Server

A live-data MCP server that validates AI claims by probing endpoints, counting competitors, and testing hypotheses against current registries.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "anish632-ground-truth-mcp": {
      "url": "https://ground-truth-mcp.<your-subdomain>.workers.dev/mcp"
    }
  }
}

Ground Truth MCP Server enables you to validate AI claims against live data by probing endpoints, counting competitors, and testing hypotheses using real-time registries. It helps you verify assumptions during research and decision making, reducing the risk of acting on outdated or incorrect information.

How to use

You can connect your MCP client to the Ground Truth MCP Server to run live checks, verify claims, and aggregate results across multiple endpoints. Use the provided tools to probe URLs, count competitors in package registries, and test hypotheses against dynamic data. Start by connecting your client to the server URL, then run checks and view per-test verdicts and overall conclusions, so you can make informed decisions based on current data.

How to install

Prerequisites: you need Node.js installed on your system. Ensure you have npm available to install dependencies and run commands.

# Install dependencies for the Ground Truth MCP Server project
npm install

# Start the local development server (if you are developing locally)
npm start

# When ready to deploy to Cloudflare Workers (production)
npm run deploy

Additional setup and usage notes

Connect to the MCP server using a client that supports HTTP MCP endpoints. Use the following URL to reach the Ground Truth MCP Server in your environment: https://ground-truth-mcp.<your-subdomain>.workers.dev/mcp. This URL is intended for use with any MCP client that can connect via HTTP transport.

If you are using the MCP Inspector for a quick test, run the following command and then enter the server URL when prompted.

npx @modelcontextprotocol/inspector@latest
# Enter: https://ground-truth-mcp.<your-subdomain>.workers.dev/mcp

Security and deployment notes

Only expose the MCP endpoint to trusted clients. When deploying to Cloudflare Workers, ensure your subdomain is properly managed and that access is restricted as needed. Monitor rate limits and authentication requirements if you enable protected endpoints or shared API access.

What to expect when you run checks

Ground Truth provides per-test verdicts and an overall conclusion for each claim you verify. For example, you may see verdicts like SUPPORTED, REFUTED, or PARTIALLY SUPPORTED, along with contextual details about the checks performed and any notable observations from live data.

Examples of available checks

The server exposes tools to probe endpoints, estimate market presence, and test hypotheses across live data sources.

Troubleshooting

If you cannot reach the MCP URL, verify your subdomain, network access, and that the server is deployed and running. Check that your MCP client is configured to use the correct HTTP endpoint and that any required authentication is configured if enabled.

Available tools

check_endpoint

Probe a URL or API endpoint. Returns HTTP status, content type, response time, auth requirements, rate limit headers, and a structural summary of the response.

estimate_market

Count packages/servers in a space on npm or PyPI. Returns total count, top results with version history and update dates, and activity signals.

test_hypothesis

Test a factual claim against multiple live checks. Returns pass/fail per test and an overall verdict: SUPPORTED, REFUTED, or PARTIALLY SUPPORTED.