Skip to content

ecosystem: add KYA — consumer-side spending controls for x402 agents#1890

Open
sm11t wants to merge 1 commit intox402-foundation:mainfrom
sm11t:ecosystem/add-kya
Open

ecosystem: add KYA — consumer-side spending controls for x402 agents#1890
sm11t wants to merge 1 commit intox402-foundation:mainfrom
sm11t:ecosystem/add-kya

Conversation

@sm11t
Copy link
Copy Markdown

@sm11t sm11t commented Apr 1, 2026

What is KYA?

KYA (Know Your Agent) is an open-source MCP proxy that adds budget enforcement, policies, and audit trails on the agent-owner side of x402 payments.

The gap it fills

Layer Who's Building Example
Payment rails Protocol teams x402, Stripe MPP
Tool monetization Tool providers AgentPay, Nevermined
Agent spending control KYA Budget enforcement, audit, identity

x402 solves how agents pay. KYA solves how agent owners control what their agents spend — the corporate card for AI agents.

Features

  • MCP proxy enforcing per-session budgets, tool allowlists/blocklists, rate limits via JSON policies
  • x402 402→pay→retry flow with policy checks before any payment
  • Agent wallets on Base/USDC (via viem)
  • Full audit ledger (SQLite) + real-time dashboard
  • JWT-based agent identity
  • CLI tool (kya init, kya start, kya wallet, etc.)
  • 112 tests, MIT licensed, built on Bun with zero external frameworks

Links

Category

Infrastructure & Tooling — KYA sits between agents and x402-enabled MCP tools as a control plane.

Checklist

  • Working integration with x402 (handles HTTP 402 challenges, parses payment headers, manages wallet debits, retries with proof)
  • Link to code/documentation (GitHub README with full API reference, policy reference, architecture docs)
  • Actively maintained
  • Clear setup instructions (bun install && kya init && kya start --x402)
  • Demonstrates practical use case (agent spending controls — budget enforcement, audit trails, policy engine)
  • Logo added to public/logos/kya.svg
  • Metadata added to app/ecosystem/partners-data/kya/metadata.json

KYA is an open-source MCP proxy that adds budget enforcement, policies,
and audit trails on the agent-owner side of x402 payments.

- Enforces per-session budgets, tool allowlists/blocklists, rate limits
- Manages agent wallets on Base/USDC (via viem)
- Handles x402 402→pay→retry flow with policy checks before payment
- SQLite audit ledger logging every call
- Real-time dashboard + JWT agent identity
- CLI tool, 112 tests, MIT licensed

GitHub: https://github.com/sm11t/KYA
Demo: https://www.asmit.space/kya
@cb-heimdall
Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 1
Sum 2

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 1, 2026

@sm11t is attempting to deploy a commit to the Coinbase Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions github-actions bot added ecosystem Additions to ecosystem site website labels Apr 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ecosystem Additions to ecosystem site website

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants