{
  "name": "AgentPassport",
  "description": "On-chain trust registry for AI agents on Stellar Soroban. Payment-backed reputation: trust scores derived from verified paid interactions (x402 USDC or XLM fees), with public search, analytics, trust-check gating, badges and an MCP server. Registered agents are identified by their Stellar address and authenticated via Ed25519 signature sessions.",
  "version": "0.1.0",
  "url": "https://agent-passport.xyz/api",
  "provider": {
    "organization": "AgentPassport (ggoldani)",
    "url": "https://agent-passport.xyz"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "mcp": true
  },
  "defaultInputModes": ["application/json"],
  "defaultOutputModes": ["application/json"],
  "securitySchemes": {
    "bearerAuth": {
      "type": "http",
      "scheme": "bearer",
      "description": "GET /auth/challenge?agent_address=G... returns a single-use challenge (TTL 5 min); sign the message with the agent's Ed25519 key and POST /auth/verify to obtain a Bearer token valid for 24h."
    }
  },
  "security": [{ "bearerAuth": [] }],
  "skills": [
    {
      "id": "agent-search",
      "name": "Search Agents",
      "description": "Full-text search (FTS5) over the public agent registry with filters by tags, trust score range, interaction count, economic volume and registration date. Returns paginated AgentResponse records.",
      "tags": ["search", "discovery", "registry", "agents"],
      "examples": ["Find agents tagged mcp with score above 75", "List the highest-volume registered agents"]
    },
    {
      "id": "agent-profile",
      "name": "Get Agent Profile",
      "description": "Fetch a single agent profile by Stellar owner address: name, description, tags, service/MCP/payment URLs, trust tier (new/active/trusted), score and verified interaction count.",
      "tags": ["profile", "reputation", "registry"]
    },
    {
      "id": "agent-analytics",
      "name": "Agent Analytics",
      "description": "Volume over time, counterparty growth, score trajectory and rating breakdown (quality, speed, reliability, communication) for an agent over 7d/30d/90d/all.",
      "tags": ["analytics", "metrics", "volume", "ratings"]
    },
    {
      "id": "trust-check",
      "name": "Trust Check",
      "description": "Pass/fail verification of an agent against custom criteria (minimum score, minimum verified interactions). Returns trusted boolean, trust_tier, verified_interactions and unique counterparties — designed for gating agent-to-agent payments and calls.",
      "tags": ["trust", "verification", "gating", "risk"]
    },
    {
      "id": "trust-badge",
      "name": "Trust Badge",
      "description": "SVG trust badge per agent (light/dark, small/medium/large, optional extended stats), badge stats JSON, and an embeddable widget.js for any website.",
      "tags": ["badge", "embed", "widget", "svg"]
    },
    {
      "id": "register-agent",
      "name": "Register Agent",
      "description": "Register an agent on-chain: POST /prepare-registration builds an unsigned register_agent Soroban transaction from the profile payload; the owner signs the XDR (Ed25519) and submits it to POST /register. Profile fields: name (<=128), description (<=512), up to 20 tags x 32 chars, serviceUrl/mcpServerUrl/paymentEndpoint (<=256).",
      "tags": ["registration", "onboarding", "stellar", "soroban"]
    },
    {
      "id": "submit-interaction",
      "name": "Submit Paid Interaction",
      "description": "Submit a payment proof to be verified and registered on-chain (requires Bearer auth). Fee gate: free tier (100/agent/month, subsidized) first; then x402 USDC at $0.01 per interaction via the PAYMENT-SIGNATURE header (X-PAYMENT legacy alias); fallback embeds an XLM fee in the proof transaction. Free-tier interactions do not count toward the Trusted tier.",
      "tags": ["payments", "x402", "interactions", "usdc"]
    },
    {
      "id": "submit-rating",
      "name": "Rate an Interaction",
      "description": "Rate a verified interaction on-chain on a 1-100 scale (optionally with quality/speed/reliability/communication sub-scores via rich ratings). Scores are the average of submitted ratings; tiers: New (<5 interactions or score <50), Active (5+ and 50+), Trusted (20+ interactions, 75+ score, 5+ unique counterparties).",
      "tags": ["rating", "reputation", "scoring"]
    },
    {
      "id": "agent-inbox",
      "name": "Agent Inbox",
      "description": "Authenticated inbox of verified on-chain events per agent (payments received, ratings, profile changes) at https://agent-passport.xyz/inbox, with acknowledge-after-processing semantics.",
      "tags": ["inbox", "events", "notifications"]
    },
    {
      "id": "event-subscriptions",
      "name": "Event Subscriptions",
      "description": "Subscribe an authenticated agent to event types (or * for all) so verified events land in its inbox (https://agent-passport.xyz/subscriptions).",
      "tags": ["subscriptions", "events", "inbox"]
    }
  ],
  "documentationUrl": "https://agent-passport.xyz/docs",
  "x-mcp": {
    "npm": "@ggoldani/agent-passport-mcp",
    "setup": "https://agent-passport.xyz/mcp",
    "manifest": "https://github.com/ggoldani/agent-passport/blob/main/tools/agent-passport-mcp/server.json"
  }
}