Social Perks

io.github.benzatkulak-collabPublished by GitHub account benzatkulak-collabv0.1.0Updated Oct 24, 2026

Agent-native marketing platform: create campaigns, submit proofs, review submissions.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

A remote marketing platform server that lets an assistant price marketing actions, create and launch campaigns, submit proof, and review submissions.

What you can do
Look up market-rate pricing for a marketing action and industry benchmarks by business type, and list the available marketing actions with filters for platform, type and effort. Search influencers by platform and follower count. List a business's campaigns and create and launch new ones, returning the campaign id, name and dashboard URL. Submit proof of completion for a campaign action as a public URL, screenshot, video or platform-verified data. Review, approve or reject submissions, list submissions by state, and read per-campaign stats such as approved count, conversion rate and perks issued.
When to use it
Useful when an assistant helps a business plan and run social marketing campaigns end to end: pricing an action, picking influencers, launching a campaign, collecting proof and reviewing submissions. Also suited to reporting campaign performance back to the user.
Requirements
A remote streamable HTTP endpoint at socialperks.app; no package install is needed. Some tools, such as listing campaigns, require authentication, though the manifest declares no auth method, environment variables or headers.
Before you install
Creating a campaign launches it immediately with no separate publish step. Approving a submission releases a perk, and rejecting one requires a reason. Proof submissions may include public post URLs, screenshots or videos sent to the platform. Campaign and submission data is tied to the calling business, so confirm which account is in use before writing.

Installation

In SourceWeft

  1. Open Social Perks in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.benzatkulak-collab%2Fsocialperks/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "social-perks": {
      "type": "http",
      "url": "https://socialperks.app/api/mcp"
    }
  }
}

README

Social Perks

The Marketing Value Protocol — AI-powered marketing infrastructure for every business.

107 marketing actions across 15 platforms. Pricing oracle for AI agents. Campaign execution layer.

Quick Start

bash
npm installnpm run dev

Open http://localhost:3000.

Demo Accounts

All use PIN: 1234

EmailBusiness Type
[email protected]Yoga Studio
[email protected]Restaurant
[email protected]Salon
[email protected]Gym
[email protected]Coffee Shop
[email protected]Tattoo Parlor
[email protected]Veterinarian
[email protected]Florist
[email protected]Law Firm
[email protected]Auto Mechanic

Or sign up as any business type — the AI adapts.

Tech Stack

  • Next.js 15 (App Router)
  • React 19
  • TypeScript
  • Tailwind CSS
  • Instrument Serif + DM Sans + JetBrains Mono

Using with Claude Code

This project includes a CLAUDE.md file that gives Claude Code full context about the architecture, design system, and what needs building next. Just run:

bash
claude

in the project directory and Claude will understand the full codebase.

License

Proprietary. All rights reserved.

Source: README.md at commit f1e4fb0

Tools

10

getPricing

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

ParametersactionIdplatformIdbusinessType

listActions

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

ParameterspagetypeperPagemaxEffortplatformId

getBenchmarks

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

ParametersbusinessType

listCampaigns

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

Parametersstatus

searchInfluencers

Search influencers by platform and follower count.

ParametersplatformminFollowers

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.

ParametersnamerequiredactionsrequiredbusinessIdrequireddescriptiondiscountTyperequireddiscountValuerequiredexpiresInDaysmaxCompletions

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 campaign's verification mode).

ParametersactionIdrequiredmetadataproofUrlrequiredproofTyperequiredcampaignIdrequired

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.

ParametersreasondecisionrequiredsubmissionIdrequired

listSubmissions

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

ParameterspagestateperPagebusinessIdcampaignId

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.

ParameterscampaignIdrequired

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.