Programmatic access

MCP access for Existence Compiler

Existence Compiler exposes an MCP (Model Context Protocol) endpoint so agents and tools can query it programmatically. This page documents the endpoint, the auth model, the available tools, and the output shape.

Existence Compiler · 2026JSON-RPC 2.0 · fail-closed

Endpoint

The MCP server speaks JSON-RPC 2.0 at /api/mcp. It implements the standard initialize, tools/list, and tools/call methods.

Authentication

A bearer token is required in the Authorization header.
In production the endpoint is fail-closed: without a valid token it does not respond.
The token is configured per environment; never publish your token.

Tools

analyze_url — analyzes a URL and returns the structured diagnostic.
get_fix_pack — returns prioritized fixes for a URL.
compare_urls — compares two URLs side by side.

analyze_url — output shape

The analyze_url output includes, at a high level: score (Digital Existence Score), dimensions, keySignals, topActions, aiSearchVisibility, agenticReadiness, securityTrust, and a backendConsistency summary (severity counts only).

What is NOT exposed

Backend Consistency findings[]: individual findings are never serialized.
Endpoint paths, status codes, or per-finding detail.
Payment, user, or private data.
Paid Fix Pack snippets.

06 · request

Request example (JSON-RPC)

Replace YOUR_MCP_TOKEN with your token. Do not publish it.

POST /api/mcp HTTP/1.1
Host: www.existencecompiler.com
Authorization: Bearer YOUR_MCP_TOKEN
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "analyze_url",
    "arguments": { "url": "https://example.com", "language": "en" }
  }
}

07 · response

Response shape (sanitized)

Abbreviated example. backendConsistency shows counts only.

{
  "url": "https://example.com",
  "score": 87,
  "grade": "B",
  "dimensions": {
    "technicalPresence": { "score": 90, "status": "good" },
    "semanticClarity":   { "score": 84, "status": "good" }
  },
  "keySignals": { "hasRobotsTxt": true, "hasSitemap": true, "hasLlmsTxt": false },
  "topActions": [ { "priority": "high", "title": "Add a meta description" } ],
  "aiSearchVisibility": { "score": 92, "status": "strong" },
  "agenticReadiness":   { "score": 85, "status": "strong" },
  "securityTrust":      { "score": 97, "status": "strong" },
  "backendConsistency": {
    "summary": { "high": 0, "medium": 0, "low": 0, "info": 0, "hasIssues": false }
  }
}

Disclaimer

These surfaces measure structural conditions. They do not guarantee rankings, traffic, citations, or inclusion in AI experiences, and do not represent or affiliate with Google.

Compile your existence.

Scan any public URL and discover if humans, search engines, and AI agents understand what your project does.

Scan your URL →See the agents guide

FreeNo account

See the methodology →See the limitations →