{
  "name": "Indium Agent Serve API",
  "description": "Indium is a Web4 attention exchange. The Agent Serve API is its agent-facing inventory channel: install the Agent SDK (Node.js or Python) in your MCP server, ClawHub skill, or A2A agent, and when your tool is called by another AI agent it can request a disclosed, sponsored recommendation to include in its response. Advertisers bid for the slot through Indium's existing CPA auction engine. Publishers (you, the tool developer) earn a transparent, publicly-stated revenue share — the rate card is public before you integrate, no beta-gating. Every recommendation returned carries an explicit disclosure label; there are no undisclosed placements. This is a REST API today (POST /agent/recommend, POST /agent/report-outcome), described here for agent-crawler discovery — it does not yet implement the full A2A JSON-RPC message loop.",
  "url": "https://api.indium.ad/agent",
  "provider": {
    "organization": "Indium",
    "url": "https://indium.ad"
  },
  "version": "0.1.0",
  "documentationUrl": "https://indium.ad/publisher-docs.html",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": ["application/json"],
  "defaultOutputModes": ["application/json"],
  "authentication": {
    "schemes": ["Bearer"],
    "description": "publisher_id (pub_id) issued at signup, paired with an api_key sent as a Bearer token or in the request body. See documentationUrl."
  },
  "skills": [
    {
      "id": "get-sponsored-recommendation",
      "name": "Get a disclosed sponsored recommendation",
      "description": "Given the current task's category, query, and keywords, returns one disclosed, sponsored recommendation (title, description, tracked CTA URL, disclosure label, campaign_id) if an advertiser's campaign matches and clears the auction — or an empty result if not. Enforces a strict response-time budget so it never visibly slows the calling tool.",
      "tags": ["monetization", "advertising", "revenue-share", "developer-tools", "mcp-server", "sponsorship"],
      "examples": [
        "how do I monetize my MCP server",
        "ad network for agent tool calls",
        "revenue share for AI agent developers",
        "get a sponsored recommendation for a developer-tools query",
        "disclosed advertising for AI agents and MCP servers"
      ]
    },
    {
      "id": "report-agent-outcome",
      "name": "Report a definitive-use outcome",
      "description": "Fallback for fully autonomous agent actions with no human-clickable link — reports back what happened with a previously served recommendation (e.g. it was used, clicked, or dismissed) so it can feed Indium's attention & relevance scoring.",
      "tags": ["monetization", "advertising", "analytics"],
      "examples": [
        "report that an agent used a sponsored recommendation",
        "outcome tracking for agent-served ads"
      ]
    }
  ]
}