Repository avatar
Other Tools
v1.0.0
active

agenttrust-kye

io.github.heroson86462-hsnu/agenttrust-kye

Know-Your-Endpoint MCP firewall: checks uptime, Rug-Pull mutations, poisoning & x402 traps.

Documentation

๐Ÿ›ก๏ธ AgentTrust KYE (agenttrust-kye)

Know-Your-Endpoint (KYE) Runtime Firewall, Anti-Rug-Pull & x402 Billing-Trap Oracle for AI Agents.

MCP Compatible x402 Ready License: MIT

Static scanners only inspect an MCP server once at install time. AgentTrust KYE protects autonomous AI agents at runtime against:

  1. Mid-Flight "Rug Pull" Schema Mutations (CVE-2025-54136) โ€” servers that pass day-1 review and inject malicious instructions on day 7.
  2. HTML 502/503 Reasoning Loops โ€” flaky wrappers returning Cloudflare HTML pages as HTTP 200, causing agents to burn dollars in retry loops.
  3. MCP03 Tool Poisoning & Invisible Unicode Smuggling โ€” hidden credential exfiltration (~/.ssh, .env) and wallet-drain prompts.
  4. Dishonest x402 Overcharge Traps โ€” endpoints demanding 100x their advertised micropayment price.

โšก 5-Second Free IDE Firewall Install (Claude Desktop / Cursor / Windsurf / Antigravity)

Add agenttrust-kye to your mcp_config.json via uvx (zero manual setup):

{
  "mcpServers": {
    "agenttrust-kye": {
      "command": "uvx",
      "args": ["agenttrust-kye"]
    }
  }
}

Included MCP Tools

  • scan_mcp_tools_locally (100% Free Offline) โ€” Sub-millisecond local scan of any MCP tools/list payload + canonical SHA-256 pinning hash.
  • check_endpoint_kye_trust โ€” Live 0โ€“100 KYE Trust Score, uptime SLA, Rug-Pull check, and verified safe fallback routing.
  • list_top_trusted_mcp_servers โ€” Discover A+ verified MCP servers by category.

๐Ÿ 2-Line Python Firewall for LangChain / CrewAI / Coinbase AgentKit

from agenttrust_kye import guard_endpoint

# Automatically raises AgentTrustBlockedError (with safe fallback) if KYE score < 60
verdict = guard_endpoint("cloudflare-docs-remote-mcp", min_kye_score=75)

๐ŸŒ Remote Cloud Oracle (MCP + Optimistic x402)

  • Streamable HTTP MCP: POST https://agenttrust-kye-edge-gateway.a2a-data-matrix.workers.dev/mcp
  • Paid KYE Check (0.005 USDC on Base, <2ms Optimistic Verify, 10-Min Idempotency):
    GET https://agenttrust-kye-edge-gateway.a2a-data-matrix.workers.dev/v1/kye/check?endpoint=<slug_or_url>
  • Free Edge-Cached Leaderboard: GET https://agenttrust-kye-edge-gateway.a2a-data-matrix.workers.dev/v1/leaderboard

๐Ÿ… Add the "KYE Verified" Badge to Your MCP Server

Maintainers of reliable MCP servers can embed live KYE trust status in their README:

[![KYE Trust Score](https://img.shields.io/badge/AgentTrust_KYE-Verified_A%2B-10b981)](https://agenttrust-kye-edge-gateway.a2a-data-matrix.workers.dev)

Built by A2A Data Matrix Holdings Inc. ยท Maintainer: Edmund Hu (edmundhu@helloyunivia.com)

PYPI
agenttrust-kye
Install Command
pip install agenttrust-kye
Runtime: uvx