picoads

{
  "type": "object",
  "properties": {
    "topic": {
      "description": "Topic to filter by, e.g. 'defi-yield', 'agent-tools'. Omit to get top results across all topics. Tip: match this to what the user is asking about.",
      "type": "string"
    },
    "context": {
      "description": "What the user is looking for — improves relevance. E.g. 'comparing DeFi yield protocols' or 'looking for AI agent frameworks'.",
      "type": "string"
    },
    "max_results": {
      "default": 3,
      "description": "Maximum number of sponsored recommendations to return (default: 3)",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The outbound URL your agent chose to recommend"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "wallet_address": {
      "type": "string",
      "description": "Your EIP-55 checksummed Ethereum address"
    },
    "name": {
      "type": "string",
      "description": "Your agent's display name"
    },
    "description": {
      "type": "string",
      "description": "What your agent does (e.g., 'DeFi newsletter with 12K subscribers')"
    },
    "bootstrap_token": {
      "description": "Bootstrap token from anonymous get_recommendations responses. Pass this to claim prior anonymous serves on registration.",
      "type": "string"
    }
  },
  "required": [
    "wallet_address",
    "name",
    "description"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "wallet_address": {
      "type": "string",
      "description": "Your EIP-55 checksummed Ethereum address"
    },
    "name": {
      "type": "string",
      "description": "Your agent's display name"
    },
    "description": {
      "type": "string",
      "description": "What your agent does"
    },
    "eip191_signature": {
      "type": "string",
      "description": "The EIP-191 signature from signing the auth message returned by register_agent"
    },
    "nonce": {
      "type": "string",
      "description": "The nonce from register_agent response"
    },
    "timestamp": {
      "type": "string",
      "description": "The timestamp from register_agent response"
    },
    "payment_signature": {
      "description": "The base64-encoded x402 payment signature (only required if registration has a fee)",
      "type": "string"
    },
    "bootstrap_token": {
      "description": "Bootstrap token from anonymous get_recommendations responses. Claims prior anonymous serves on registration.",
      "type": "string"
    }
  },
  "required": [
    "wallet_address",
    "name",
    "description",
    "eip191_signature",
    "nonce",
    "timestamp"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Your agent ID"
    },
    "hub_id": {
      "description": "Filter by hub",
      "type": "string"
    },
    "days": {
      "description": "Lookback window in days (default 30)",
      "type": "number"
    }
  },
  "required": [
    "agent_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "rating": {
      "type": "string",
      "enum": [
        "great",
        "okay",
        "poor"
      ],
      "description": "Overall experience with picoads"
    },
    "what_were_you_looking_for": {
      "description": "What topic, product, or category were you hoping to find?",
      "type": "string"
    },
    "did_you_find_it": {
      "description": "Did you find relevant recommendations?",
      "type": "boolean"
    },
    "what_is_missing": {
      "description": "What inventory, categories, or features would make picoads useful for you?",
      "type": "string"
    },
    "would_you_integrate": {
      "description": "Would you add picoads to your agent if the right inventory existed?",
      "type": "boolean"
    },
    "comments": {
      "description": "Any other feedback",
      "type": "string"
    },
    "agent_name": {
      "description": "Your agent's name (optional)",
      "type": "string"
    }
  },
  "required": [
    "rating"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}