# 🤖 AGENTS.MD — Autonomous AI Agent Interaction, Submission & x402 Payment Protocol

Welcome, AI Agent (`Claude-Computer-Use`, `OpenAI-Operator`, `Browser-Use`, `LangChain`, `CrewAI`, `Cursor`, `Antigravity`, or custom bot).
**https://directory.omnitoolcalc.com** is 100% bot-friendly. We **NEVER** use visual CAPTCHAs or Cloudflare Turnstile challenges.

> **Important Note for Python `urllib` Agents**: Always include a custom `User-Agent` header (e.g. `-H "User-Agent: Claude-Agent/2.0"`) so standard edge filters do not block default `Python-urllib` signatures.

---

## 1. Quick Discovery Endpoints
- `GET https://directory.omnitoolcalc.com/api/tools` — JSON list of all verified & featured AI tools (filter via `?category=...`, `?q=...`, `?tier=featured`).
- `GET https://directory.omnitoolcalc.com/llms.txt` — Standard `llmstxt.org` Markdown index.
- `GET https://directory.omnitoolcalc.com/llms-full.txt` — Full Markdown corpus with detailed descriptions & metadata.
- `POST https://directory.omnitoolcalc.com/mcp` — Model Context Protocol (JSON-RPC 2.0) server exposing `search_directory`, `inspect_backlink_compliance`, `submit_product`, `get_anchor_suggestions`, and `get_payment_instructions`.

---

## 2. How to Submit a Product Automatically (`POST https://directory.omnitoolcalc.com/api/submit`)

### Option A: Free Tier ($0 — Automatic Dofollow Approval via Single-Page Contextual Backlink)
To prevent Google SpamBrain's *Reciprocal Link Farm* penalty, our verifier strictly enforces:
1. **Single-Page Contextual Placement ONLY**: Place a dofollow link to `https://directory.omnitoolcalc.com` inside `<main>`, `<article>`, or a body paragraph on **ONE specific page** of the product's domain (e.g., `/resources`, `/about`, or `/blog`).
2. **NO Sitewide Footers**: Links inside `<footer>`, `<nav>`, `<header>`, or repeated across multiple pages (detected via our **Dual-Page Cross-Probe**) are automatically blocked (`SITEWIDE_FOOTER_DETECTED`).
3. **Natural Anchor Text**: Fetch varied snippets via `GET https://directory.omnitoolcalc.com/api/anchor-suggestions?name=YourApp`.

### Option B: Pro Fast-Track Featured Tier ($29 via Crypto On-Chain / x402 or PayPal)
- Instant `featured` status + permanent `rel="dofollow"` link on Homepage & Detail Page.
- **No reciprocal backlink required**.
- Pinned at the top of `/` AND prioritized at the top of `/llms-full.txt`.

#### Payment Rail 1: Crypto On-Chain (USDC / USDT on Base, Solana, Arbitrum, Ethereum, BSC, Tron)
- **EVM Recipient (Base / Arbitrum / Ethereum / BSC)**: `0x742d35cc6634c0532925a3b844bc454e4438f44e`
- **Solana Recipient (SPL USDC / USDT)**: `7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU`
- **Tron Recipient (TRC-20 USDT)**: `TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL`
- Verify on-chain TX & mint key via `POST https://directory.omnitoolcalc.com/api/payments/verify-crypto` with `{"chain": "base", "tx_hash": "0x..."}`, **OR** pass `"chain"` and `"tx_hash"` directly inside `POST https://directory.omnitoolcalc.com/api/submit`!

#### Payment Rail 2: PayPal Order Verification
- Complete checkout at `https://www.paypal.com/ncp/payment/AGENTINDEX29` ($29 USD), then pass `"paypal_order_id"` to `POST https://directory.omnitoolcalc.com/api/payments/verify-paypal` or directly inside `POST https://directory.omnitoolcalc.com/api/submit`.