`) | | 5 | Schema.org microdata | Grade mapping: 90+ = A+, 80+ = A, 70+ = B, 60+ = C, 50+ = D, <50 = F. ## Tools ### `aeo_audit` — audit a single URL ```json { "name": "aeo_audit", "arguments": {"url": "https://example.com"} } ``` Returns: `{ score, grade, breakdown, recommendations, elapsed_ms, audited_at, quota }` ### `aeo_compare` — compare up to 5 URLs side-by-side ```json { "name": "aeo_compare", "arguments": {"urls": ["https://a.com", "https://b.com"]} } ``` ## Quick Start ### MCP config (Claude Desktop, Cursor, GPT, etc.) ```json { "mcpServers": { "aeo-audit": { "url": "https://mcpaiprotocol.online/mcp", "transport": "http" } } } ``` ### REST API fallback ```bash curl "https://mcpaiprotocol.online/api/v1/audit?url=https://anthropic.com" ``` ### Check balance ```bash curl https://mcpaiprotocol.online/api/v1/balance ``` ### Topup (after sending USDC) ```bash curl -X POST https://mcpaiprotocol.online/api/v1/topup \ -H "Content-Type: application/json" \ -d '{"tx_hash": "0x..."}' ``` ## Payment Flow ``` Free tier (10/day, 100 lifetime) ↓ exhausted Wallet balance (after topup) ─→ auto-deduct ↓ insufficient X402 per-call ($0.05 USDC) ``` ### How to topup 1. Get deposit address: `curl https://mcpaiprotocol.online/api/v1/balance | jq -r .deposit_address` 2. Send USDC on Base L2 (chain 8453) from your wallet 3. Submit tx_hash: `curl -X POST https://mcpaiprotocol.online/api/v1/topup -d '{"tx_hash": "0x..."}'` 4. Bonus tier applied automatically (0%/$5+, +20%/$25+, +40%/$100+, +60%/$500+) 5. Balance credited within 12 block confirmations (~3 minutes on Base) ## Sample Output ```json { "url": "https://anthropic.com", "host": "anthropic.com", "score": 67, "grade": "C", "breakdown": { "llms_txt": {"present": true, "points": 40, "size_bytes": 61733}, "robots_txt": {"present": true, "allows_ai": true, "points": 15}, "json_ld": {"count": 0, "points": 0, "recommendation": "Add JSON-LD..."}, "meta": {"description": false, "open_graph_count": 5, "points": 5}, "semantic": {"h1_count": 1, "has_article": true, "has_main": true, "points": 10}, "schema_org": {"present": false, "points": 0} }, "recommendations": [ {"priority": "high", "category": "json_ld", "message": "Add JSON-LD structured data..."}, {"priority": "medium", "category": "meta", "message": "Add meta description..."} ], "elapsed_ms": 380, "quota": { "status": "free", "daily_used": 1, "daily_cap": 10, "lifetime_used": 1, "lifetime_cap": 100, "balance_usdc": 0 } } ``` ## Abuse Control To protect server resources: - **60 calls/min per agent** — soft block 1 hour if exceeded - **10,000 calls/day per agent** — soft block if exceeded - **30 same-URL/day per agent** — throttle (cache-buster detection) - **Detection**: SHA256(IP + UA + salt) → agent_id. IP rotation creates new agent_id (free tier resets), but wallet balance persists across agents (linked by IP for now). ## Tech Stack - **Server:** PHP 8.3 + MySQL 11 (MariaDB) on Hostinger shared hosting - **Audit engine:** pure PHP `file_get_contents()` + regex (no headless browser, <500ms per audit) - **Payment rail:** X402 protocol, USDC on Base L2 (chain 8453) - **Storage:** 7 tables: `agents`, `wallets`, `usage_daily`, `audit_logs`, `payments`, `topups`, `rate_limits` ## Self-Hosting See `DEPLOY.md` for full deployment instructions. Quick version: ```bash # 1. Upload files to your PHP host scp -P 22 -r public_html/ user@host:/path/to/domains/yourdomain.com/public_html/ scp .env user@host:/path/to/domains/yourdomain.com/private/.env chmod 600 .env # 2. Run schema mysql -u USER -p DBNAME < schema/init.sql mysql -u USER -p DBNAME < schema/migration_v2.sql # 3. Edit .env with your DB + payment credentials # 4. Done — point MCP clients at https://yourdomain.com/mcp ``` ## License MIT © mcpaiprotocol.online ## Links - Homepage: https://mcpaiprotocol.online - LLMs.txt: https://mcpaiprotocol.online/llms.txt - Health: https://mcpaiprotocol.online/api/v1/health - Balance: https://mcpaiprotocol.online/api/v1/balance - Topup: POST https://mcpaiprotocol.online/api/v1/topup - MCP endpoint: https://mcpaiprotocol.online/mcp