io.github.benzatkulak-collab/socialperks

Social Perks

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

Endpointhttps://socialperks.app/api/mcp (streamable-http)
Registry version0.1.0
Now10 tools · grade B (82) · pin ts_6e05b54d1da9086c93e217c2813074a5 · protocol 2025-03-26
First / last listed2026-10-26 07:52 UTC / 2026-10-26 07:52 UTC
Grade over time2026-10-26: B (82), 10 tools

Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.

Timeline

First listing · 2026-10-26 07:52 UTC
10 tools, grade B (82)

Tools: getPricing listActions getBenchmarks listCampaigns searchInfluencers createCampaign submitProof reviewSubmission listSubmissions getCampaignStats

Current tools (10)

getPricingGet the market-rate pricing for a marketing action. Returns USD value and recommended perk type/value.
params: actionId, platformId, businessType
listActionsList the 125 marketing actions available on Social Perks. Filterable by platform, type, and effort.
params: platformId, type, maxEffort, page, perPage
getBenchmarksGet industry benchmarks (engagement rate, conversion rate, etc.) for a business type.
params: businessType
listCampaignsList campaigns. Requires auth — returns the caller's campaigns.
params: status
searchInfluencersSearch influencers by platform and follower count.
params: platform, minFollowers
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.
params: businessId*, name*, description, actions*, discountValue*, discountType*, maxCompletions, expiresInDays
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).
params: campaignId*, actionId*, proofUrl*, proofType*, metadata
reviewSubmissionApprove or reject a submission. Approving releases the perk; rejecting requires a reason. Use this when the business chooses manual review over auto-verification.
params: submissionId*, decision*, reason
listSubmissionsList submissions for a business or campaign, filterable by state (pending/approved/rejected). Returns paginated results.
params: businessId, campaignId, state, page, perPage
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.
params: campaignId*

Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.