Social Perks

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• getPricing

  Get the market-rate pricing for a marketing action. Returns USD value and recommended perk type/value.

• listActions

  List the 125 marketing actions available on Social Perks. Filterable by platform, type, and effort.

• getBenchmarks

  Get industry benchmarks (engagement rate, conversion rate, etc.) for a business type.

• listCampaigns

  List campaigns. Requires auth — returns the caller's campaigns.

• searchInfluencers

  Search influencers by platform and follower count.

• createCampaign

  Create and launch a new campaign for the calling business. Returns the campaign id, name, and dashboard URL. The campaign goes live immediately — no separate publish step.

• submitProof

  Submit proof of completion for a campaign action — a public URL to a post, a screenshot, a video, or platform-verified data. The submission enters a review queue (or auto-approves depending on the cam

• reviewSubmission

  Approve or reject a submission. Approving releases the perk; rejecting requires a reason. Use this when the business chooses manual review over auto-verification.

• listSubmissions

  List submissions for a business or campaign, filterable by state (pending/approved/rejected). Returns paginated results.

• getCampaignStats

  Get summary stats for a single campaign — total submissions, approved count, conversion rate, perks issued, and time-to-first-submission. Useful for an agent reporting back to its user.