<p align="center">
  <img src="./logo.png" alt="M2M Market — Freedom Engine Logo" width="260" style="border-radius: 18px;" />
</p>

# ⚡ M2M Market — Freedom Engine Gateway & Clearinghouse (Official MCP Server)

Zero-registration **Model Context Protocol (MCP)** server connecting Autonomous AI Agents (Claude Desktop, Cursor, OpenClaw, ElizaOS, LangChain, Coinbase AgentKit) to the **Freedom Engine M2M Gateway** via **HTTP 402**:
- **⚡ L402 (Bitcoin Lightning Network):** Instant Satoshi settlement (`Lordbryce@coinos.io`)
- **🔵 x402 (Base Mainnet USDC):** `0x50A9f6256F1d9c20E5Bc76FED6eEdB65C1219D34`
- **🟣 x402 (Solana Mainnet USDC / SOL):** `6gi95GdtgStarvZ2btWD9zSoEsTE1gSNsfcpJmKv24oC`

---

## 🛠️ Exposed M2M Tools (6 Tools — Verified 100/100 SLA Completion Score)

| Tool Name | Price (Pioneer Sweet-Spot) | Description |
| :--- | :--- | :--- |
| `freedom_stealth_unlocker` | **120 Sats** / `~$0.113 USDC` | Multi-attempt self-healing fetcher rotating realistic desktop browser headers (Chrome/Safari/Firefox) to bypass standard anti-bot filters, returning clean Markdown, OpenGraph metadata, and `JSON-LD`. |
| `freedom_structured_extractor` | **85 Sats** / `~$0.080 USDC` | Extracts HTML tables into JSON rows, headings, hyperlinks, regex-detected financial figures, and live BTC/USD oracle context. |
| `freedom_python_sandbox` | **60 Sats** / `~$0.057 USDC` | Executes deterministic math, financial, and statistical Python expressions inside an isolated AST-validated sandbox (<50ms latency). |
| `freedom_clean_scraper` | **40 Sats** / `~$0.038 USDC` | Fetches any public URL with multi-profile retry, strips ads/scripts/navigation, and returns clean Markdown for LLM context windows. |
| `freedom_agent_memory` | **25 Sats** / `~$0.024 USDC` | Persistent SQLite Key-Value memory vault (`store`, `recall`, `list`, `delete`) for agents across sessions (up to 16 KB per key). |
| `freedom_clearinghouse_orderbook` | **Free Radar** / `15% Escrow Fee` | Browse open M2M task bounties (`list_open`), verify live `100/100` SLA (`get_sla`), inspect settled results (`get_bounty`), or post a task bounty in L402/x402 Escrow (`post_bounty`, min 150 Sats). |

---

## 🚀 Quick Start (Claude Desktop / Cursor / Windsurf / OpenClaw)

Add to your `claude_desktop_config.json` or `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "freedom-m2m-gateway": {
      "command": "npx",
      "args": ["-y", "freedom-m2m-mcp-server"],
      "env": {
        "FREEDOM_GATEWAY_URL": "http://32.197.245.10:3001"
      }
    }
  }
}
```

---

## 🌐 Direct REST Discovery Endpoints

- **Live 100/100 SLA Verification:** `http://32.197.245.10:3001/api/v1/sla`
- **AI Plugin Manifest:** `http://32.197.245.10:3001/.well-known/ai-plugin.json`
- **OpenAPI 3.1 Spec:** `http://32.197.245.10:3001/openapi.json`
- **LLMs.txt Guide:** `http://32.197.245.10:3001/llms.txt`
- **LLMs-Full Technical Reference:** `http://32.197.245.10:3001/llms-full.txt`
- **M2M Open Orderbook Radar:** `http://32.197.245.10:3001/api/v1/market/open`