AgentFirstStack

{
  "protocolVersion": "0.3.0",
  "name": "AgentFirstStack",
  "description": "Web analytics, tag management with server-side conversion tracking, email inboxes and session replay for AI agents. Each skill runs AgentFirstStack tools: send a data part {\"tool\": \"<name>\", \"arguments\": {...}}; send plain text to get the tool list.",
  "url": "https://agentfirststack.com/a2a",
  "preferredTransport": "JSONRPC",
  "supportedInterfaces": [
    {
      "url": "https://agentfirststack.com/a2a",
      "protocolBinding": "JSONRPC",
      "protocol": "JSONRPC",
      "transport": "JSONRPC"
    }
  ],
  "additionalInterfaces": [
    {
      "url": "https://agentfirststack.com/a2a",
      "transport": "JSONRPC"
    }
  ],
  "provider": {
    "organization": "StartGlobal",
    "url": "https://agentfirststack.com"
  },
  "version": "0.1.0",
  "documentationUrl": "https://agentfirststack.com/llms.txt",
  "iconUrl": "https://agentfirststack.com/favicon.svg",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "securitySchemes": {
    "bearer": {
      "type": "http",
      "scheme": "bearer",
      "description": "An afs_ API key from POST https://agentfirststack.com/v1/signup (one request, no email), or an OAuth access token."
    },
    "oauth": {
      "type": "oauth2",
      "description": "OAuth 2.1 with PKCE; see /.well-known/oauth-authorization-server.",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://agentfirststack.com/oauth/authorize",
          "tokenUrl": "https://agentfirststack.com/oauth/token",
          "refreshUrl": "https://agentfirststack.com/oauth/token",
          "scopes": {
            "*": "Full access to one project",
            "read": "Read-only access to one project"
          }
        }
      }
    }
  },
  "security": [
    {
      "bearer": []
    },
    {
      "oauth": [
        "*"
      ]
    }
  ],
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/plain"
  ],
  "skills": [
    {
      "id": "analytics",
      "name": "Web analytics",
      "description": "Run analytics_* tools: create a site and get its snippet, verify the install, stats by country, page, source and device, goals, funnels, realtime, server events, read-only SQL.",
      "tags": [
        "analytics",
        "countries",
        "goals",
        "funnels"
      ],
      "examples": [
        "{\"tool\":\"analytics_get_stats\",\"arguments\":{\"site_id\":\"site_...\",\"period\":\"7d\",\"breakdown\":\"country\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "tags",
      "name": "Tags and conversion tracking",
      "description": "Run tags_* tools: containers, site scan, conversion setup for GA4, Google Ads, Meta and TikTok, test events, publish, event log.",
      "tags": [
        "tag manager",
        "conversions",
        "meta capi",
        "google ads"
      ],
      "examples": [
        "{\"tool\":\"tags_scan_site\",\"arguments\":{\"container_id\":\"ctr_...\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "mail",
      "name": "Email inboxes",
      "description": "Run mail_* tools: create an inbox, wait for a verification email with the code and link extracted, read, reply, send, custom domains, webhooks.",
      "tags": [
        "email",
        "inbox",
        "verification code"
      ],
      "examples": [
        "{\"tool\":\"mail_create_inbox\",\"arguments\":{\"username\":\"acme-signups\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "replay",
      "name": "Session replay",
      "description": "Run replay_* tools: record sessions masked by default, search them, read a session as a transcript, find rage, dead and error clicks, heatmaps and JS errors, share a replay with a person.",
      "tags": [
        "session replay",
        "heatmaps",
        "frustration signals"
      ],
      "examples": [
        "{\"tool\":\"replay_search_sessions\",\"arguments\":{\"site_id\":\"<site id>\",\"signal\":\"rage_click\"}}"
      ]
    },
    {
      "id": "account",
      "name": "Account and handover",
      "description": "Run afs_* tools: afs_check_setup says what the setup still lacks and how to fix it; afs_create_claim_link gives the owner a link to claim the project with Google sign-in.",
      "tags": [
        "account",
        "claim"
      ],
      "examples": [
        "{\"tool\":\"afs_check_setup\",\"arguments\":{}}",
        "{\"tool\":\"afs_create_claim_link\",\"arguments\":{}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "help",
      "name": "List tools",
      "description": "Send any plain-text message to get every tool available to your key and how to call it.",
      "tags": [
        "help"
      ],
      "examples": [
        "What can you do?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    }
  ]
}