Agent Ready Roadmap

Implementation plan for full agent-ready compliance

Project Overview

Transform the Monte Carlo Data platform into a fully agent-ready system implementing modern AI accessibility standards including MCP, OAuth discovery, Agent Skills, content negotiation, and agentic commerce protocols.

Total Development Time
10.5 hours

Expected Impact

Current State
25/100 points
Basic discoverability in place, missing advanced protocols
After Implementation
100/100 points
Full MCP + OAuth + Skills + Commerce stack, automated platform
Agent Readiness Score
+75 points
25% → 100% agent-ready per isitagentready.com

Implementation Phases

Phase 1: Discoverability & Bot Access Control

2 hours
Current Score
15/40
Target Score
40/40
  • •
    robots.txt with AI bot rules
    Currently: Missing or incomplete. Will add: GPTBot, ClaudeBot, PerplexityBot allow/disallow rules + crawl-delay directives
  • •
    XML Sitemap
    Currently: No sitemap reference. Will add: Auto-generated sitemap with all public pages, proper lastmod timestamps
  • •
    Link Headers
    Currently: No discovery headers. Will add: Link rel=alternate, rel=sitemap, and canonical headers on all responses
  • •
    Content Signals
    Currently: No metadata. Will add: X-Content-Signals headers indicating data freshness, update frequency, content type

Phase 2: Content Accessibility

4 hours
Current Score
10/20
Target Score
20/20
  • •
    Markdown Content Negotiation
    Currently: HTML only. Will add: Accept: text/markdown support on all content endpoints, automatic HTML-to-Markdown conversion middleware
  • •
    Structured Data
    Currently: No schema markup. Will add: JSON-LD with Organization, WebSite, BreadcrumbList schemas on every page
  • •
    Clean Semantic HTML
    Currently: Potentially cluttered markup. Will refactor: Use semantic tags (article, section, nav), strip unnecessary divs, improve heading hierarchy
  • •
    Accessible Navigation
    Currently: Unknown ARIA support. Will ensure: Proper ARIA labels, keyboard navigation, focus management for agent traversal

Phase 3: Protocol Discovery (MCP, OAuth, Agent Skills)

3 hours
Current Score
0/30
Target Score
30/30
  • •
    MCP Server Card
    Currently: No MCP endpoint. Will create: /.well-known/mcp-server.json with server metadata, capabilities, supported tools/prompts
  • •
    Agent Skills Manifest
    Currently: No skill definitions. Will add: SKILL.md files defining agent-executable workflows, input/output schemas, and usage examples
  • •
    OAuth Discovery
    Currently: No OAuth metadata. Will implement: /.well-known/oauth-authorization-server endpoint with token URLs, scopes, grant types
  • •
    API Catalog
    Currently: Undocumented APIs. Will publish: OpenAPI 3.1 spec at /api-catalog.json with all endpoints, request/response schemas, authentication requirements

Phase 4: Commerce & Web Bot Auth

1.5 hours
Current Score
0/10
Target Score
10/10
  • •
    Web Bot Auth
    Currently: No bot authentication. Will implement: /.well-known/web-bot-auth endpoint with VAPID keys for verified bot access
  • •
    x402 Payment Headers
    Currently: No payment metadata. Will add: HTTP 402 responses with x402 payment required headers on premium content endpoints
  • •
    Testing & Validation
    Run isitagentready.com scan, verify all endpoints return correct headers, test Markdown negotiation with curl
  • •
    Documentation
    Create README with agent integration examples, update API docs with new endpoints, publish changelog

Deliverables

100/100 agent-ready score (isitagentready.com)
Full MCP server implementation
Agent Skills manifest with executable workflows
OAuth + API catalog + OpenAPI 3.1 spec
Markdown content negotiation on all endpoints
Complete implementation documentation