Claude MarketplacesSubmit
benzatkulak-collab avatar

Social Perks

benzatkulak-collab/socialperks

This is an agent-native marketing platform that exposes 107 marketing actions across 15 platforms through an MCP interface. You'd reach for this when you want Claude to create marketing campaigns, submit proofs of completion, or review user submissions programmatically. The server connects to socialperks.app's API and runs over streamable HTTP transport. It's built as a pricing oracle and campaign execution layer, letting AI agents understand marketing action costs and trigger campaigns across different business types. The demo accounts suggest it handles everything from yoga studios to law firms, with the system adapting its marketing actions based on business context.

tools
10
transport
HTTP
last updated
May 16, 2026
View on GitHub

Install

From registry metadata
$ npx add-mcp https://socialperks.app/api/mcp --name socialperks

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http socialperks https://socialperks.app/api/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 10 tools

Verified live against the running server on Nov 6, 2026.

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

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

Parameters* required
actionIdstring
Action ID (e.g. ig_post, google_review)
businessTypestring
Business type modifier (default: general)
platformIdstring
Platform ID (e.g. instagram, google)
listActionsList the 125 marketing actions available on Social Perks. Filterable by platform, type, and effort.5 params

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

Parameters* required
maxEffortinteger
pageinteger
default: 1
perPageinteger
default: 50
platformIdstring
typestring
one of content · review · engage · share · referral
getBenchmarksGet industry benchmarks (engagement rate, conversion rate, etc.) for a business type.1 params

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

Parameters* required
businessTypestring
Industry name or slug (e.g. 'restaurants', 'coffee-shops'). Omit for the full catalog.
listCampaignsList campaigns. Requires auth — returns the caller's campaigns.1 params

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

Parameters* required
statusstring
one of draft · active · paused · completed
searchInfluencersSearch influencers by platform and follower count.2 params

Search influencers by platform and follower count.

Parameters* required
minFollowersinteger
platformstring
createCampaignCreate 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.8 params

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.

Parameters* required
actions*array
Action IDs the campaign accepts (e.g. ['ig_st'] for an Instagram Story Tag).
businessId*string
The business owning this campaign. Must match the API key's business.
descriptionstring
Optional internal description
discountType*string
Discount denomination: 'pct' for percentage, 'dol' for dollars off.one of pct · dol
discountValue*number
Discount amount. Capped at 100 for pct, 10000 for dol.
expiresInDaysinteger
Days until the campaign auto-expires. Default 60.
maxCompletionsinteger
Optional cap on total completions. Null = no cap.
name*string
Customer-facing campaign name
submitProofSubmit 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).5 params

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).

Parameters* required
actionId*string
Specific action being completed (must be allowed by the campaign).
campaignId*string
Campaign the submission applies to.
metadataobject
Optional bag of context (poster handle, post timestamp, etc.).
proofType*string
How the proof was captured. 'url' triggers automated verification.one of screenshot · url · video · api_verified
proofUrl*string
Public URL of the proof. For url-type submissions, the platform verifier will fetch this.
reviewSubmissionApprove or reject a submission. Approving releases the perk; rejecting requires a reason. Use this when the business chooses manual review over auto-verification.3 params

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

Parameters* required
decision*string
Approve releases the perk. Reject explains why the proof was insufficient.one of approve · reject
reasonstring
Required when decision='reject'. 1-500 chars.
submissionId*string
Submission id from a prior submitProof call.
listSubmissionsList submissions for a business or campaign, filterable by state (pending/approved/rejected). Returns paginated results.5 params

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

Parameters* required
businessIdstring
campaignIdstring
pageinteger
default: 1
perPageinteger
default: 25
statestring
one of pending · approved · rejected
getCampaignStatsGet 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.1 params

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.

Parameters* required
campaignId*string
Campaign to fetch stats for.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

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

npm install
npm run dev

Open http://localhost:3000.

Demo Accounts

All use PIN: 1234

EmailBusiness Type
yoga@demo.comYoga Studio
sol@demo.comRestaurant
glow@demo.comSalon
iron@demo.comGym
baked@demo.comCoffee Shop
ink@demo.comTattoo Parlor
vet@demo.comVeterinarian
bloom@demo.comFlorist
smith@demo.comLaw Firm
spark@demo.comAuto 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:

claude

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

License

View the full README on GitHub

Details

Repository
github.com/benzatkulak-collab/socialperks
Categories
Sales & Marketing, AI & LLM Tools
Transport
HTTP
Registry
MCP registry, active
Tools verified
Nov 6, 2026

Related Sales & Marketing MCP servers

View all
1clutch avatarClutch.coco.clutch/mcpTrusted B2B service providers with verified client reviews0stars
2codex-curator avatarIntelligence Aeternumcodex-curator/intelligence-aeternum-mcpAI training dataset marketplace: 2M+ museum artworks with Golden Codex enrichment0stars
3industrylensop avatarIndustryLensindustrylensop/industrylens-mcp-docsB2B SaaS competitor pricing changes, strategic moves, market landscapes, reports and comparisons.0stars
4ipogrid avatarIPOGrid IPO Calendar & Filing Researchcom.ipogrid/ipogridIPO calendar, SEC filings, deal terms, and IPO news research via the IPOGrid MCP server.0stars
5lionx402 avatarLION — Verified Company & Compliance Datacom.lionx402/lion-x402Keyless x402 compliance on Base: $0.001 OFAC wallet screen, $0.05 pack, $0.95 company file.0stars
6logo-kit avatarLogoKit Brand & Company Datalogo-kit/logokit-mcpCompany & brand data by domain or ticker/ISIN: industry, headcount, HQ, social, colors, logos.0stars