Amba

Activity Feeds

Auto-generated activity feeds from engagement events using feed rules.

Activity feeds show social activity within your app. Set up feed rules to automatically create feed items when users track specific events.

How it works

  1. Admin creates feed rules that map engagement events to feed actions
  2. When a user tracks a matching event, a feed item is created automatically
  3. Users can browse their feed to see friends' activity

Feed rules

A feed rule has:

  • source_event — the engagement event that triggers feed item creation
  • action — the action string in the feed item (e.g., "reached_streak_milestone")
  • target_type — optional target type for context

Example rule

When a user tracks streak_milestone, create a feed item with action reached_streak_milestone:

{
  "source_event": "streak_milestone",
  "action": "reached_streak_milestone",
  "target_type": "streak"
}

Client API reference

MethodPathDescription
GET/client/feedsGet the user's activity feed
GET/client/feeds/friendsGet friends' activity feed

MCP tools

ToolDescription
amba_create_feed_ruleCreate a rule to auto-generate feed items from events

Example

Agent: "Set up feed items for achievements and streak milestones"

amba_create_feed_rule({
  project_id: "proj_xxx",
  source_event: "achievement_unlocked",
  action: "unlocked_achievement"
})

amba_create_feed_rule({
  project_id: "proj_xxx",
  source_event: "streak_milestone",
  action: "reached_streak_milestone",
  target_type: "streak"
})

Database tables

TablePurpose
feed_rulesRules mapping events to feed actions
feed_itemsGenerated feed items with actor, action, and target

On this page