Send Visit Events From Your AWS Website

Step 1: Create a Data Firehose Stream

• Open your AWS dashboard
• In the search bar at the top of the screen, type in and select Amazon Data Firehose
• Click Create Firehose stream
• Select Direct PUT as a source, and HTTP endpoint as a destination
• Name the stream something like known-agents-analytics
• Enter this HTTP endpoint URL as the destination:

https://api.knownagents.com/logs/aws

• Navigate to the Known Agents Projects page and open your project
• Copy your access token from the Settings page
• Back in AWS, paste in your access token where it says Access key
• Select GZIP content encoding
• Under Backup settings, create a new bucket to record failed logs (this is required by AWS).
• Click Create Firehose stream

Step 2: Connect Your CloudFront Distribution

• Navigate back to your AWS dashboard and select your CloudFront distribution
• Select the Logging tab
• In the Access log destinations section, click the Add dropdown menu and select Amazon Kinesis Data Firehose
• Choose the stream you just created as the Destination stream
• Click Submit

Step 3: Test Your Integration

• Navigate to the Projects page
• Select your project
• Click Settings
• Click Send a Test Visit
• Click Realtime

If your website is correctly connected, you should see visits from a test agent in the realtime timeline within a few seconds.

MCP Calls and Agentic Commerce Interactions

This integration only sends pageview events. If you also want to send MCP calls and agentic commerce interactions, send those events through the REST API. For example, you can use the Cloudflare Worker alongside this integration. Otherwise, use the Cloudflare Worker guide as an example of how to send only MCP calls and agentic commerce interactions without duplicating pageview events.