# Site Analyzer Agent API & MCP Server

> Machine-to-Machine programmatic API and Model Context Protocol (MCP) server for autonomous AI agents, LLM assistants, and developer workflows to perform website diagnostics, extract metadata/contacts, check AI readiness, and purchase technical SEO audit reports with sub-cent x402 micropayments.

## Server & Endpoint Declarations
- **MCP Endpoint**: `POST https://siteanalyzerfree.com/api/v1/agent/mcp.php` (Streamable HTTP transport, JSON-RPC 2.0 protocol version `2024-11-05`).
- **REST Endpoints**:
  - `POST https://siteanalyzerfree.com/api/v1/agent/url-checker.php` ($0.001 USD)
  - `POST https://siteanalyzerfree.com/api/v1/agent/metadata-extractor.php` ($0.002 USD)
  - `POST https://siteanalyzerfree.com/api/v1/agent/dns-auth.php` ($0.003 USD)
  - `POST https://siteanalyzerfree.com/api/v1/agent/change-detector.php` ($0.005 USD)
  - `POST https://siteanalyzerfree.com/api/v1/agent/ai-readiness.php` ($0.005 USD)
  - `POST https://siteanalyzerfree.com/api/v1/agent/contact-extractor.php` ($0.005 USD)
  - `POST https://siteanalyzerfree.com/api/v1/agent/checkup.php` ($1.00 USD)
  - `POST https://siteanalyzerfree.com/api/v1/agent/full-audit.php` ($39.00 USD)
- **OAuth Discovery**: `GET https://siteanalyzerfree.com/.well-known/oauth-authorization-server`
- **OpenAPI 3.0 Spec**: `GET https://siteanalyzerfree.com/openapi.json`

## Available Tools & Products

### Sub-Cent AI Agent Micro-Tools ($0.001 - $0.005 USD via x402)
Designed specifically for autonomous LLM agents to bypass sandbox network blocks and save token context overhead:
- `check_url_status` ($0.001 USD): Follows redirects, checks HTTP status codes, measures response latency (ms), and captures headers.
- `extract_website_metadata` ($0.002 USD): Returns page title, meta description, OpenGraph, Twitter Cards, canonical URL, JSON-LD schemas, and headings structure.
- `check_dns_email_auth` ($0.003 USD): Resolves A, AAAA, MX, TXT records and validates SPF (`v=spf1`) and DMARC (`_dmarc`) email security directives.
- `detect_website_changes` ($0.005 USD): Stateful DOM hashing and snapshot comparison. Detects body changes, title changes, and status diffs against past visits.
- `check_ai_readiness` ($0.005 USD): Analyzes `robots.txt` rules for AI crawlers (GPTBot, ClaudeBot, etc.), `llms.txt` availability, sitemaps, and AI discoverability score.
- `extract_contact_info` ($0.005 USD): Extracts emails (decoding obfuscation), phone numbers, social media profiles, and contact page links.

### Free Diagnostic Tools ($0.00 USD)
- `check_noindex_status`: Instantly checks if a domain or URL is blocked from search engine indexing.
- `lookup_whois_and_domain_age`: Looks up WHOIS registration details, domain age, creation/expiration dates, and registrar.
- `check_dns_and_headers`: Analyzes SSL certificate validity, HTTP security headers, and DNS TTL records.
- `check_web_hosting`: Identifies web server type, hosting provider, IP address, CDN usage, and response headers.
- `analyze_web_page_word_count`: Analyzes word count, main content ratio, reading time, and readability score.

### Paid Technical Audits & Micro-Reports
- `run_quick_seo_checkup` ($1.00 USD / 10 Credits): Fast technical health scan evaluating titles, meta tags, security headers, canonical redirects, and DNS.
- `run_full_seo_audit` ($39.00 USD): Exhaustive 30+ check technical audit report with deep architecture analysis and remediation instructions.

## Authentication & Autonomous Micropayments
Supports API Keys, OAuth 2.0, and **HTTP 402 (X402) Machine Micropayments**:
- **API Key**: Include `Authorization: Bearer agent_sk_live_...` or `X-API-Key` header.
- **HTTP 402 (X402) Machine Micropayments**: Autonomous AI agents without pre-registered accounts can access paid endpoints on demand.
  - Unauthenticated requests receive HTTP status `402 Payment Required` with `X-402-Price`, `X-402-Pay-To`, `X-402-Network` (Base Mainnet / USDC), and `X-402-Challenge`.
  - Resubmit with header `Authorization: X-402 <tx_hash>` or `Authorization: X-402 test_tx_12345` (sandbox mode).

## Response Formats
Requests support `format: "json"` (structured key-value data) or `format: "markdown"` (clean Markdown summary tailored for LLM prompt contexts).