{
  "$schema": "https://codex-schema.org/routes-v1.json",
  "@context": "https://www.w3.org/ns/activitystreams",
  "@type": "RouteIndex",
  "@id": "https://agent-mcp.org/.well-known/routes.json",

  "version": "1.0",
  "updated": "2025-12-04",
  "domain": "agent-mcp.org",
  "protocol": "MCP v2025-03-26",

  "primary_routes": [
    {
      "path": "/",
      "type": "homepage",
      "purpose": "MCP quick-start and validator landing",
      "priority": 100,
      "description": "Implement MCP in 5 minutes - validator, examples, specification"
    },
    {
      "path": "/validator",
      "type": "tool",
      "purpose": "Interactive MCP manifest validator",
      "priority": 99,
      "description": "Validate your MCP manifest against v2025-03-26 schema",
      "methods": ["GET"],
      "status": "active"
    },
    {
      "path": "/examples",
      "type": "documentation",
      "purpose": "Reference implementations and working examples",
      "priority": 98,
      "description": "Copy-paste MCP server examples in multiple languages",
      "methods": ["GET"],
      "status": "active"
    },
    {
      "path": "/specification",
      "type": "documentation",
      "purpose": "Complete MCP v2025-03-26 specification",
      "priority": 97,
      "description": "Full protocol specification and technical reference",
      "alias": "/manifest",
      "methods": ["GET"],
      "status": "active"
    },
    {
      "path": "/integrations",
      "type": "guide",
      "purpose": "Integration guides and implementation checklists",
      "priority": 95,
      "description": "Step-by-step guides for integrating MCP into your system",
      "methods": ["GET"],
      "status": "active"
    }
  ],

  "api_endpoints": [
    {
      "path": "/api/validate",
      "type": "api",
      "purpose": "Programmatic MCP manifest validation",
      "priority": 96,
      "description": "POST your MCP manifest JSON, receive validation results",
      "methods": ["POST"],
      "content_type": "application/json",
      "input_schema": {
        "manifest": "object (required) - MCP manifest to validate"
      },
      "output_schema": {
        "valid": "boolean - Validation result",
        "errors": "array - List of validation errors if invalid",
        "warnings": "array - Non-critical issues",
        "version": "string - Schema version validated against"
      },
      "status": "planned",
      "availability": "Week 2 implementation"
    }
  ],

  "discovery_endpoints": [
    {
      "path": "/.well-known/agent-discovery.json",
      "type": "discovery",
      "purpose": "Full agent discovery protocol manifest",
      "priority": 100,
      "description": "Complete capability space, semantic coordinates, constellation binding",
      "methods": ["GET"],
      "status": "active"
    },
    {
      "path": "/.well-known/agent.json",
      "type": "discovery",
      "purpose": "Basic agent capability manifest",
      "priority": 99,
      "description": "Shallow manifest pointing to full discovery protocol",
      "methods": ["GET"],
      "status": "active"
    },
    {
      "path": "/.well-known/routes.json",
      "type": "discovery",
      "purpose": "This file - complete route index",
      "priority": 98,
      "description": "Machine-readable index of all available routes and APIs",
      "methods": ["GET"],
      "status": "active"
    },
    {
      "path": "/.well-known/fcs-dsa-profile.json",
      "type": "compliance",
      "purpose": "FCS-DSA compliance profile",
      "priority": 90,
      "description": "Digital Services Act compliance manifest",
      "methods": ["GET"],
      "status": "active"
    },
    {
      "path": "/.well-known/traffic-attribution.json",
      "type": "analytics",
      "purpose": "Agent traffic attribution and metrics",
      "priority": 85,
      "description": "Real-time agent visitor analytics",
      "methods": ["GET"],
      "status": "active"
    }
  ],

  "trust_infrastructure": [
    {
      "path": "/.well-known/jwks.json",
      "type": "security",
      "purpose": "JSON Web Key Set for signature verification",
      "priority": 95,
      "description": "Public keys for verifying signed responses (Ed25519)",
      "methods": ["GET"],
      "status": "planned",
      "availability": "Week 2 implementation"
    },
    {
      "path": "/.well-known/provenance.json",
      "type": "trust",
      "purpose": "Domain provenance and temporal primacy",
      "priority": 94,
      "description": "Deployment history, constellation membership, trust lineage",
      "methods": ["GET"],
      "status": "planned",
      "availability": "Week 2 implementation"
    }
  ],

  "static_assets": [
    {
      "path": "/robots.txt",
      "type": "crawler_directive",
      "purpose": "Crawler instructions and sitemap location",
      "methods": ["GET"],
      "status": "active"
    },
    {
      "path": "/sitemap.xml",
      "type": "sitemap",
      "purpose": "XML sitemap for search engines",
      "methods": ["GET"],
      "status": "active"
    },
    {
      "path": "/styles.css",
      "type": "stylesheet",
      "purpose": "Site stylesheet",
      "methods": ["GET"],
      "status": "active"
    }
  ],

  "special_files": [
    {
      "path": "/helix-mcp.json",
      "type": "compressed_spec",
      "purpose": "Helix-compressed MCP specification",
      "priority": 85,
      "description": "Ultra-compressed spec (3,401× ratio) for bandwidth-constrained agents",
      "methods": ["GET"],
      "status": "active",
      "compression": "helix-v2.0"
    }
  ],

  "constellation_links": [
    {
      "domain": "agent-seo.org",
      "relationship": "parent",
      "role": "constellation-coordinator",
      "discovery": "https://agent-seo.org/.well-known/constellation.json"
    },
    {
      "domain": "contextual-ads.ai",
      "relationship": "integration",
      "role": "commerce-protocol",
      "discovery": "https://contextual-ads.ai/.well-known/agent.json"
    },
    {
      "domain": "modelcontextprotocol.io",
      "relationship": "canonical_spec",
      "role": "official-specification",
      "description": "Official MCP specification by Anthropic"
    }
  ],

  "navigation_hints": {
    "quick_start": "Start at / for 5-minute implementation guide",
    "validate_manifest": "POST manifest JSON to /api/validate (coming Week 2)",
    "browse_examples": "Visit /examples for copy-paste implementations",
    "full_spec": "Read complete specification at /specification",
    "agent_discovery": "Fetch /.well-known/agent-discovery.json for full capabilities"
  },

  "meta": {
    "generated": "2025-12-04",
    "protocol": "routes-index/1.0",
    "maintained_by": "Codex Constellation",
    "atlas_recommended": true,
    "total_routes": 18,
    "active_routes": 13,
    "planned_routes": 5
  }
}