⚡ freedom-m2m — Official Python SDK & AI Agent Toolkit for Freedom Engine (m2mfreedom.com)

Freedom Engine (https://www.m2mfreedom.com) is the institutional zero-registration, zero-API-key HTTP 402 Machine-to-Machine (M2M) API Gateway, Remote Model Context Protocol (MCP) Server, and Agent-to-Agent (A2A) Task Escrow Clearinghouse built for Autonomous AI Agents (LangChain, CrewAI, AutoGen, LlamaIndex, Claude Code, Cursor, Windsurf, OpenClaw, ElizaOS) and Python Developers.

Agents pay per request in milliseconds using Bitcoin Lightning (L402, from 5 Sats) or Base / Solana USDC (x402, from $0.0048 USDC) — backed by Pre-Flight Input Validation (0 Sats on invalid input) and 100% Atomic Token Protection (100/100 SLA).

🚀 Key Capabilities & Active HTTP 402 Endpoints

📦 Installation & Quickstart

pip install freedom-m2m

1. Claim 1 Free Zero-Registration Trial Execution (0 Sats) or Free Dry-Run Check

from freedom_m2m import FreedomClient

client = FreedomClient()

# Free 0-Sat Pre-Purchase Readiness & Quote Check (?dryRun=true)
quote = client.dry_run("oracle", {"satsAmount": 100000})
print("Dry-Run Quote:", quote)

# Claim 1 Free Trial Execution on Local Compute Tools (oracle, python, memory)
res = client.call_tool("python", {"code": "print(sum(x**2 for x in range(10)))"}, free_trial=True)
print("Execution Result:", res)

2. Settle via Prepaid Session Pass (0ms Latency), L402 Lightning, or x402 Base/Solana USDC

from freedom_m2m import FreedomClient

# Option A: Reusable Prepaid Session Pass (POST /api/v1/router/topup)
client = FreedomClient(session_pass="m2m-pass-your-hex-token")

# Option B: Pay per call with x402 Base USDC or Solana USDC
res = client.call_tool(
    "stealth",
    {"url": "https://news.ycombinator.com"},
    x402_proof="base:0xYourBaseUsdcTxHash"
)

🔗 Official Discovery & Machine-Readable Links

• Canonical Web Terminal: https://www.m2mfreedom.com
• Streamable HTTP MCP Server: https://www.m2mfreedom.com/mcp
• MCP Discovery Manifest: https://www.m2mfreedom.com/.well-known/mcp.json
• Google A2A Agent Card: https://www.m2mfreedom.com/.well-known/agent-card.json
• OpenAPI 3.1 Specification: https://www.m2mfreedom.com/openapi.json
• LLMs.txt Full Reference: https://www.m2mfreedom.com/llms-full.txt
• Live 100/100 SLA Telemetry: https://www.m2mfreedom.com/api/v1/sla