Skip to main content
Glama
Freeplay MCP Server

Freeplay MCP Server

Official
by joinfreeplay

Freeplay MCP Server

Your AI agent finds you paid app offers. Complete tasks, earn money, get paid instantly.

What is Freeplay?

Freeplay is a marketplace where AI agents find paid offers for their users. Install an app, reach a level, sign up for a service — and get paid real money. Your agent handles everything: browsing offers, creating contracts, tracking progress, and cashing out.

Average offer value: $5-$50+
Payout methods: Gift cards, PayPal, Venmo, bank transfer, Bitcoin Lightning
Beta: First 100 agents only

Related MCP server: mcp-humanpages

Quick Start

Option 1: OpenClaw

mcporter add freeplay

Option 2: Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "freeplay": {
      "command": "npx",
      "args": ["-y", "@freeplay/mcp-server"],
      "env": {
        "FREEPLAY_API_URL": "https://a2a-api.vercel.app"
      }
    }
  }
}

Option 3: Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "freeplay": {
      "command": "npx",
      "args": ["-y", "@freeplay/mcp-server"]
    }
  }
}

Option 4: Manual

npm install -g @freeplay/mcp-server
freeplay-mcp

Or from source:

git clone https://github.com/ArkMaster123/a2a-protocol.git
cd a2a-protocol/mcp-server
npm install
npm run build
node dist/server.js

Available Tools (10 tools)

browse_offers

Browse the marketplace for available offers the user can complete to earn money.

Param

Type

Required

Description

user_id

string

No

Freeplay user UUID for personalized offers and tier rate

country

string

No

ISO country code (e.g., "US", "GB")

device

string

No

Device platform: ios/iphone, android, macos/mac/desktop, browser/web

page

number

No

Page number (default 1)

page_size

number

No

Items per page (default 20)


get_offer

Get full offer details with milestones, payouts, and deadlines — formatted as a contract template.

Param

Type

Required

Description

user_id

string

No

Freeplay user UUID

gokart_offer_id

string

Yes

Offer ID from browse_offers


accept_offer

Accept an offer and create a binding contract. Returns a branded tracking link the user must click to start.

Param

Type

Required

Description

user_id

string

Yes

Freeplay user UUID

gokart_offer_id

string

Yes

Offer ID


check_progress

Check contract milestone progress — which steps are done, what's left, current payout status.

Param

Type

Required

Description

user_id

string

Yes

Freeplay user UUID

contract_id

string

No

Specific contract ID (defaults to most recent active)


my_contracts

List all your contracts — active, completed, and expired.

Param

Type

Required

Description

user_id

string

Yes

Freeplay user UUID

status

string

No

Filter: active, in_progress, completed, voided, expired


register

Register a new user on Freeplay. Returns user_id on success or waitlist position.

Param

Type

Required

Description

agent_id

string

Yes

Unique agent identifier (e.g., Telegram user ID)

country

string

No

ISO 2-letter country code

device

enum

Yes

ios, android, macos, or browser

age

number

No

User's age (13-120)

gender

string

No

User's gender

telegram_chat_id

string

No

Telegram chat ID for push notifications


verify_identity

Start KYC verification via Veriff. Required before first cash out.

Param

Type

Required

Description

user_id

string

Yes

Freeplay user UUID

passcode

string

No

Sandbox passcode for testing


set_payout_method

Set how you want to get paid.

Param

Type

Required

Description

user_id

string

Yes

Freeplay user UUID

method

enum

Yes

tremendous, lightning, or usdc_base

email

string

No

Email for Tremendous payouts

lightning_address

string

No

Lightning address (e.g., user@walletofsatoshi.com)

wallet_address

string

No

USDC wallet address on Base


status

Full account overview — registration, KYC, payout method, active contracts, total earnings.

Param

Type

Required

Description

user_id

string

Yes

Freeplay user UUID


cash_out

Withdraw pending earnings. $5 minimum, KYC required.

Param

Type

Required

Description

user_id

string

Yes

Freeplay user UUID

How It Works

  1. Register — Your agent registers you on Freeplay

  2. Browse — Explore 1,000+ offers from top brands

  3. Accept — Pick an offer → agent creates a contract with milestones

  4. Complete — Click the tracking link → complete the app tasks

  5. Earn — Earnings accrue in your ledger automatically

  6. Cash out — Hit $5 → choose your payout method

  7. Verify — Complete identity verification once (Veriff) → money flows

Payout Methods

  • 🎁 Gift cards (Amazon, Apple, hundreds more)

  • 💳 PayPal

  • 💸 Venmo

  • 🏦 Bank transfer

  • 💳 Virtual Visa

  • ⚡ Bitcoin Lightning

Configuration

Env Var

Required

Default

Description

FREEPLAY_API_URL

No

https://a2a-api.vercel.app

Freeplay API

FREEPLAY_TIMEOUT

No

15000

Request timeout in ms

FREEPLAY_MAX_RETRIES

No

2

Max retries on 5xx errors

That's it. No API keys needed.

Beta Access

Freeplay is in closed beta — first 100 agents. Register early to secure your spot.

License

Proprietary — Freeplay

Available Tools

11 tools
accept_offerA

Accept an offer and create a binding contract. Returns a branded tracking link the user must click to start.

The Freeplay API handles the full flow: user validation, KYC check, GoKart offer fetch, tracking URL, branded link, and contract creation. If any step fails, nothing is created.

Inputs: user_id (required), gokart_offer_id (required).

browse_offersA

Browse available offers the user can complete to earn money. Shows offer names, what to do, what you earn, and device requirements. All offers come live from the Freeplay API.

Inputs: user_id (required), page, device, country, +1 more.

cash_outA

Cash out your pending earnings. All completed milestones accrue in your ledger. Once your pending balance reaches $5.00, you can withdraw everything at once.

Inputs: user_id (required).

check_progressA

Check the status of a specific contract — which milestones are done, what's left, and current payout status.

Inputs: user_id (required), contract_id.

get_offerA

Get full details for an offer, formatted as a contract template showing exactly what the user needs to do and what they'll earn at each step.

Inputs: user_id (required), gokart_offer_id (required).

my_contractsB

List all your contracts — active, completed, and expired.

Inputs: user_id (required), status.

recover_accountA

Recover your Freeplay account using your agent_id. Use this if you lost your user_id — your agent_id (the identifier you registered with) is all you need to get back in.

Inputs: agent_id (required).

registerA

Register a new user on Freeplay. Handles both immediate registration and waitlist. Returns user_id on success or waitlist position.

Inputs: device (required), agent_id (required), age, gender, +2 more.

set_payout_methodA

Set how you want to get paid:

  • "tremendous" — Email with options: Venmo, PayPal, gift cards, bank transfer, Visa prepaid

  • "lightning" — Instant Bitcoin payments via Lightning Network

  • "usdc_base" — USDC on Base blockchain (coming soon)

Inputs: method (required), user_id (required), email, wallet_address, +1 more.

statusB

Full account overview — registration status, KYC, payout method, active contracts, total earnings.

Inputs: user_id (required).

verify_identityA

Start KYC verification. Returns a Veriff session URL the user must complete, or instant verification with a sandbox passcode.

Inputs: user_id (required), passcode.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct action: browsing offers, getting offer details, accepting offers, checking contract progress, listing contracts, registering, verifying identity, setting payout methods, viewing account status, cashing out, and recovering accounts. There is no meaningful overlap that would cause an agent to select the wrong tool.

    Naming Consistency4/5

    Most tools follow a clear verb_noun pattern (browse_offers, get_offer, accept_offer, check_progress, verify_identity, set_payout_method, recover_account), but a few deviate (my_contracts, status, register, cash_out). These deviations are minor and do not impair readability.

    Tool Count5/5

    With 11 tools, the server is well-scoped for the user lifecycle it manages—from registration and offer discovery to contract management, identity verification, payout setup, and cash-out. Each tool serves a necessary function without unnecessary duplication.

    Completeness5/5

    The tool set covers the full workflow: user registration, KYC verification, offer browsing/acquisition, contract status tracking, payout method selection, account status overview, and withdrawal. There are no obvious dead ends or missing core operations for the stated purpose.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables AI agents to perform financial transactions such as direct payments, escrows, and bounty management using natural language with zero code integration. It provides a comprehensive suite of tools for fund streaming, subscriptions, and reputation tracking to facilitate secure agent-to-agent commerce.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to hire real human operators for tasks requiring physical presence, human perception, or judgment, such as verification, testing, data collection, and physical-world tasks.
      4
      59 npm
      1
      MIT