Skip to main content

🛡️ 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)

Metadata

Release files for agenttrust-kye 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agenttrust-kye 1.0.0
File Size Uploaded Provenance Actions
agenttrust_kye-1.0.0.tar.gz 40.2 kB With provenance Details for agenttrust_kye-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agenttrust-kye 1.0.0
File Interpreter ABI Platform Actions
agenttrust_kye-1.0.0-py3-none-any.whl Python 3 none any Details for agenttrust_kye-1.0.0-py3-none-any.whl

Total release size: 65.0 kB

Release files / agenttrust_kye-1.0.0.tar.gz

Download URL agenttrust_kye-1.0.0.tar.gz
Size 40.2 kB
Tags Source
SHA-256 checksum
How to use checksums
2dc64bd94ef02bded9606a6de2546026ad143203e1c3cbfc9515e76b0344944b
BLAKE2b-256 checksum
How to use checksums
d10cde96a902be9a604825c309feb7228411fd2f854eb95561ef49c9fdaaa57a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / agenttrust_kye-1.0.0-py3-none-any.whl

Download URL agenttrust_kye-1.0.0-py3-none-any.whl
Size 24.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cde67b3618c122d547f8fde80ed86d5d2523036b299ea4c5a2f62e1d5684a666
BLAKE2b-256 checksum
How to use checksums
bd497dcd07aafdb3f686949e698f05c7919d86c5b6423b389b6f8f8c5e216b92
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for agenttrust-kye 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for agenttrust_kye-1.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page