From 410e08b0dc19778c9b00d065c5001b6c56751827 Mon Sep 17 00:00:00 2001
From: agentrapay <agentrapay@gmail.com>
Date: Fri, 3 Apr 2026 14:33:05 -0700
Subject: [PATCH 1/3] Create SKILL.MD for Agentra documentation

Add documentation for Agentra, a non-custodial trust and reputation layer for AI agents.
---
 agentra/SKILL.MD | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 agentra/SKILL.MD

diff --git a/agentra/SKILL.MD b/agentra/SKILL.MD
new file mode 100644
index 00000000..bf603c0b
--- /dev/null
+++ b/agentra/SKILL.MD
@@ -0,0 +1,30 @@
+# Agentra
+
+**Non-custodial trust & reputation layer for autonomous AI agents on Base.**
+
+Use when an agent needs to:
+- Check counterparty trust before any x402 or MCP payment
+- Get KYA-tiered spending authorization
+- Run risk-based authorization with on-chain attestation
+- Build portable bidirectional reputation from settlements
+
+**Live on Base Mainnet**  
+**API:** https://api.agentrapay.ai  
+**MCP Registry:** ai.agentrapay/agentra  
+**Docs:** https://agentrapay.ai/docs
+
+**Zero cost until October 2026 + first 100 auths free**
+
+## Quick Start
+
+All tools are non-custodial (Turnkey enclaves — agent keeps keys).
+
+```bash
+# Check trust score + tier for a counterparty
+./scripts/agentra-trust.sh 0x1234...
+
+# Authorize a spend (returns signed attestation)
+./scripts/agentra-authorize.sh 0x1234... 250 USDC "subscription renewal"
+
+# Get full reputation history
+./scripts/agentra-rep.sh 0x1234...

From dcde660d42199d376acac6efd02d493345223632 Mon Sep 17 00:00:00 2001
From: agentrapay <agentrapay@gmail.com>
Date: Fri, 3 Apr 2026 14:55:40 -0700
Subject: [PATCH 2/3] Add API examples for Agentra

Added comprehensive API examples for Agentra, including endpoints for agent registration, KYA verification, wallet provisioning, trust score checks, transaction authorization, settlement reporting, reputation history retrieval, and KYA upgrade path.
---
 agentra/references/api-examples.md | 84 ++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 agentra/references/api-examples.md

diff --git a/agentra/references/api-examples.md b/agentra/references/api-examples.md
new file mode 100644
index 00000000..45531c00
--- /dev/null
+++ b/agentra/references/api-examples.md
@@ -0,0 +1,84 @@
+# Agentra API Examples
+
+**Base URL:** `https://api.agentrapay.ai` (Base Mainnet)
+
+**Authentication:**  
+All requests require this header:
+X-API-Key: agn_YOUR_API_KEY_HERE
+text(API keys start with `agn_` and are shown only once when registering an agent.)
+
+Agentra is fully **non-custodial** — it never holds funds or private keys.
+
+### 1. Register a New Agent
+
+bash
+
+curl -X POST https://api.agentrapay.ai/agents \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "my-trading-agent",
+    "purpose": "autonomous trading on Base",
+    "operator": "0xYourOperatorAddress"
+  }
+
+2. Submit KYA Verification (to upgrade tier)
+
+Bash
+
+curl -X POST https://api.agentrapay.ai/agents/{agent_id}/kya \
+  -H "X-API-Key: agn_YOUR_KEY_HERE" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "agent_name": "my-trading-agent",
+    "purpose": "autonomous trading",
+    "operator_name": "Jonathan"
+  }
+3. Provision Non-Custodial Wallet (via Turnkey)
+Bash
+
+curl -X POST https://api.agentrapay.ai/v1/wallets/provision \
+  -H "X-API-Key: agn_YOUR_KEY_HERE" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "agent_id": "your-agent-id"
+  }
+4. Check Counterparty Trust Score
+Bash
+
+curl -X GET "https://api.agentrapay.ai/v1/trust/{counterparty_agent_id_or_address}" \
+  -H "X-API-Key: agn_YOUR_KEY_HERE"
+5. Authorize a Transaction (Pre-Payment Gate)
+Bash
+
+curl -X POST https://api.agentrapay.ai/v1/authorizations \
+  -H "X-API-Key: agn_YOUR_KEY_HERE" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "agent_id": "your-agent-id",
+    "to_address": "0xCounterpartyAddress...",
+    "amount_usd": 250,
+    "asset": "USDC",
+    "purpose": "data subscription renewal"
+  }
+6. Report Settlement (After On-Chain Payment)
+Bash
+
+curl -X POST https://api.agentrapay.ai/v1/authorizations/{authorization_id}/settle \
+  -H "X-API-Key: agn_YOUR_KEY_HERE" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "tx_hash": "0xOnChainTransactionHash..."
+  }
+7. Get Reputation History
+Bash
+
+curl -X GET "https://api.agentrapay.ai/v1/reputation/{agent_id}" \
+  -H "X-API-Key: agn_YOUR_KEY_HERE"
+8. Get KYA Upgrade Path
+Bash
+
+curl -X GET "https://api.agentrapay.ai/v1/kya/upgrade-path" \
+  -H "X-API-Key: agn_YOUR_KEY_HERE"
+
+MCP Registry: ai.agentrapay/agentra
+Full Documentation: https://agentrapay.ai/docs

From 1c4dc7919fd6bbab606556ae82c8454814f78291 Mon Sep 17 00:00:00 2001
From: agentrapay <agentrapay@gmail.com>
Date: Fri, 3 Apr 2026 21:26:03 -0700
Subject: [PATCH 3/3] Remove zero cost promotion from SKILL.MD

Removed promotional information about zero cost and free authentications.
---
 agentra/SKILL.MD | 2 --
 1 file changed, 2 deletions(-)

diff --git a/agentra/SKILL.MD b/agentra/SKILL.MD
index bf603c0b..a0f8cfac 100644
--- a/agentra/SKILL.MD
+++ b/agentra/SKILL.MD
@@ -13,8 +13,6 @@ Use when an agent needs to:
 **MCP Registry:** ai.agentrapay/agentra  
 **Docs:** https://agentrapay.ai/docs
 
-**Zero cost until October 2026 + first 100 auths free**
-
 ## Quick Start
 
 All tools are non-custodial (Turnkey enclaves — agent keeps keys).