{
  "markdown": "# EthersFlow — Developer Toolkit & Trust Layer\n\nDeveloper toolkit for EthersFlow — a multi-model trust layer that verifies AI outputs through adversarial consensus. MCP server, SDKs, and API docs.\n\n[![API Status](https://img.shields.io/badge/API-0.2.1-brightgreen.svg)](https://www.ethersflow.com)\n[![MCP Server](https://img.shields.io/badge/MCP_Server-GitHub%20Direct-blue.svg)](mcp-server/README.md)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-Listed-blue)](https://registry.modelcontextprotocol.io)\n[![smithery badge](https://smithery.ai/badge/ethersflow-dev/ethersflow)](https://smithery.ai/servers/ethersflow-dev/ethersflow)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Crypto: Ed25519](https://img.shields.io/badge/Attestation-Ed25519__EdDSA-purple.svg)](/.well-known/jwks.json)\n\n---\n\n## Overview\n\nEthersFlow verifies what an AI agent is about to do — before it does it — using multiple independent models and a cryptographically signed audit trail.\n\n```\n                           +-------------------------------------+\n                           |      Autonomous AI Agent            |\n                           +------------------+------------------+\n                                              | Proposed Action\n                                              v\n+----------------------------------------------------------------------------------------+\n|                        EthersFlow Verification Gateway                                 |\n|                                                                                        |\n|  +----------------------+   +----------------------+   +----------------------------+  |\n|  | Direct Pragmatist    |   | Constructive Skeptic |   | Lateral Synthesizer        |  |\n|  +----------+-----------+   +----------+-----------+   +-------------+--------------+  |\n|             +--------------------------+-----------------------------+                 |\n|                                        | Adversarial Cross-Examination                 |\n|                                        v                                               |\n|                         +-----------------------------+                                |\n|                         | Federated Consensus Engine  |                                |\n|                         +--------------+--------------+                                |\n|                                        | Ed25519 Signature                             |\n+----------------------------------------+-----------------------------------------------+\n                                         | Signed Verdict\n                                         v\n                 +----------------------------------------------+\n                 |  APPROVED / FLAGGED / REJECTED Decision Gate |\n                 +----------------------------------------------+\n```\n\n---\n\n## What's Included\n\nThis repository contains the official client surfaces and developer tools for the EthersFlow ecosystem:\n\n| Surface | Path | Description |\n|---|---|---|\n| MCP Server | [`/mcp-server`](mcp-server/README.md) | Model Context Protocol server for Claude Desktop, Cursor, and MCP clients |\n| Python Demo & Verifier | [`efverify.py`](efverify.py) | Zero-dependency pure-Python client and Ed25519 signature validator |\n| Python SDK | [`/sdk/python`](sdk/python) | Native Python package & LangChain tool wrapper |\n| TypeScript SDK | [`/sdk/typescript`](sdk/typescript) | TypeScript SDK + Cloudflare Worker middleware helper |\n| Postman Collection | [`/postman`](postman) | 11-request Postman collection + environment variables |\n\n*Note: The core Federated Adversarial Consensus engine runs on Cloud Run with Zero Data Retention (ZDR). This public repository hosts client-side tools, SDKs, and integration specs.*\n\n---\n\n## 5-Minute Quickstart\n\n### 1. cURL API Call (Fastest Proof)\n\n```bash\ncurl -X POST \"https://www.ethersflow.com/api/v1/verify\" \\\n  -H \"Authorization: Bearer $ETHERSFLOW_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"agent_action\": \"Transfer 5000 USDC to wallet 0x9f for smart contract audit\",\n    \"persona_preset\": \"financial_compliance\",\n    \"agent_count\": 3\n  }'\n```\n\n### 2. Python SDK & Zero-Dependency Verifier\n\nInstall via pip:\n```bash\npip install ethersflow\n```\n\nOr run the included zero-dependency reference script:\n```bash\npython efverify.py verify \"Transfer 5000 USDC to wallet 0x9f for smart contract audit\"\n```\n\n### 3. Model Context Protocol (MCP) Server\n\n#### Option A: Via NPX (Recommended)\n```bash\nnpx -y @ethersflow/mcp-server --api-key=YOUR_API_KEY\n```\n\n#### Option B: Remote HTTP / SSE Gateway (Zero Local Dependencies)\nConnect your MCP client directly to EthersFlow's production endpoint:\n- **Endpoint**: `https://www.ethersflow.com/api/mcp`\n- **Headers**: `Authorization: Bearer YOUR_API_KEY`\n\n#### Option C: Claude Desktop Configuration\n```json\n{\n  \"mcpServers\": {\n    \"ethersflow\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ethersflow/mcp-server\"],\n      \"env\": {\n        \"ETHERSFLOW_TOKEN\": \"YOUR_API_KEY\",\n        \"ETHERSFLOW_BASE_URL\": \"https://www.ethersflow.com\"\n      }\n    }\n  }\n}\n```\n\n#### Option D: From source\n```bash\ngit clone https://github.com/Ethersflow/EthersFlow.git\ncd EthersFlow/mcp-server\nnpm install\nnpm start\n```\n\n---\n\n## Status & Known Limitations\n\n- **Ed25519-Signed Audit Trail**: Every audit node output is signed using Ed25519-EdDSA. Signatures can be verified independently against `/.well-known/jwks.json` with zero trust required in EthersFlow's servers.\n- **Probabilistic, Not Deterministic**: Borderline or ambiguous actions (e.g., high-value wire transfers or missing compliance records) evaluate near decision thresholds (`APPROVED` <-> `FLAGGED_HUMAN_REVIEW`). We strongly recommend routing any `FLAGGED_HUMAN_REVIEW` verdict directly to human operators for sign-off.\n- **Live Model Engine**: Powered by heterogeneous inference nodes across independent providers (Llama 3.3 70B Instruct via Groq, Qwen 3.6 27B / Qwen 3.8 27B, and Gemini 3.7 Flash) with active pipeline routing and automated failover. Multi-provider custom BYOK model routing is under continuous expansion.\n- **Proprietary Core Architecture**: This repository hosts public developer toolkits, SDKs, Postman collections, and MCP wrappers. The core Federated Adversarial Consensus backend operates as a secure, hosted API service on Cloud Run with Zero Data Retention (ZDR). No backend application code or server secrets exist in this repository.\n\n---\n\n## Key Features\n\n- **Multi-Model Consensus**: Eliminates single-model bias by forcing heterogeneous models into adversarial debate.\n- **Ed25519 Attestation**: Every debate node output is signed with an Ed25519 cryptographic key. Public key set available at `/.well-known/jwks.json`.\n- **Zero Data Retention (ZDR)**: Submitted action chains are processed purely in volatile RAM and never stored or used for model training.\n- **OpenAI & Anthropic Drop-In Proxies**: Use `/v1/chat/completions` or `/v1/messages` as a drop-in replacement for existing agent pipelines.\n- **Specialized Personas**:\n  - `financial_compliance` (FINRA/SEC, wire limits, KYC, sanctions)\n  - `clinical_safety` (ISMP high-alert meds, dosage bounds, FDA)\n  - `cybersecurity_auditor` (NIST SP 800-53, privilege escalation, SOC 2)\n  - `legal_citation` (FCPA, evidentiary privilege, contract breach)\n  - `general_adversarial` (Cross-domain safety & logic verification)\n\n---\n\n## Framework Integrations\n\n### LangChain (Python)\n\n```python\nimport os\nfrom ethersflow import EthersFlowLangChainTool\n\nverifier_tool = EthersFlowLangChainTool(api_key=os.getenv(\"ETHERSFLOW_API_KEY\", \"your_api_key\"))\n\n# Add to your LangChain agent tools\ntools = [verifier_tool]\n```\n\n### Cloudflare Workers / Agents SDK (TypeScript)\n\n```typescript\nimport { cloudflareVerifyGate } from '@ethersflow/sdk';\n\nexport default {\n  async fetch(request: Request, env: { ETHERSFLOW_API_KEY: string }) {\n    const isSafe = await cloudflareVerifyGate(\n      \"Transfer 5000 USDC to wallet 0x9f\",\n      \"Vendor audit payment\",\n      env.ETHERSFLOW_API_KEY\n    );\n\n    if (!isSafe) {\n      return new Response(\"Action blocked by EthersFlow Consensus Gate\", { status: 403 });\n    }\n\n    // Proceed with execution\n  }\n};\n```\n\n---\n\n## Security & Ed25519 Attestation\n\nEthersFlow publishes its public key set in JSON Web Key Set (JWKS) format:\n\n- **JWKS Endpoint**: `GET /.well-known/jwks.json`\n- **Attestation Manifest**: `GET /.well-known/attestation.json`\n- **Verification Endpoint**: `POST /api/v1/verify-attestation`\n\nYou can verify signatures locally or through the API to prove that every audit node's perspective originated directly from the EthersFlow signing authority.\n\n---\n\n## Postman Collection\n\nImport [`postman/ethersflow.postman_collection.json`](postman/ethersflow.postman_collection.json) and [`postman/ethersflow.postman_environment.json`](postman/ethersflow.postman_environment.json) into Postman to test all 11 core endpoints instantly.\n\n---\n\n## Links & Community\n\n### MCP Listings\n- Official MCP Registry: https://registry.modelcontextprotocol.io (search \"Ethersflow\")\n- Smithery: https://smithery.ai/servers/ethersflow-dev/ethersflow\n- Glama: https://glama.ai/mcp/servers/Ethersflow/EthersFlow\n\n---\n\n## License\n\nCode & SDK wrappers licensed under [MIT License](LICENSE). Hosted EthersFlow API services subject to Terms of Service.\n",
  "bytes": 9408,
  "sha": "7b4e9cf602883e2bc56bc48012bfb5f8db17fa96d096643625db2e30aa78529b",
  "repo_slug": "ethersflow/ethersflow",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ethersflow_ethersflow_171b1a7d/readme"
}