MCP.so
Sign In
P

PlayerOS

@movaMedia-Inc

Repository

About PlayerOS

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "PlayerOS": {
      "type": "http",
      "url": "https://api.playeros.ai/api/mcp"
    }
  }
}

Tools

25

List or search players in your property. Filter by status or an email substring; order and paginate. Returns gaming-specific fields (player_id, tier, adt, coin_in). (scope: read)

Retrieve a single player by their PlayerOS id (UUID). (scope: read)

Create a player in your property. Requires the 'write' scope. (scope: write)

Update fields on an existing player. Requires the 'write' scope. (scope: write)

Preview how many players match a set of segment conditions (no segment is saved). (scope: read)

List campaigns in your property, most recent first. (scope: read)

Retrieve a single campaign by id (UUID). (scope: read)

Create a draft campaign in your property. Requires the 'write' scope. (scope: write)

Update fields on a campaign (e.g. name, subject, status). Requires the 'write' scope. (scope: write)

Send (enqueue) an email campaign to its filtered recipients. Every recipient passes a pre-send compliance check. Requires the 'write' scope. (scope: write)

Send an SMS campaign via Telnyx. TCPA pre-check blocks suppressed and DNC numbers. Requires the 'write' scope. (scope: write)

List automation journeys (visual campaign flows) in your property. (scope: read)

Retrieve a single journey by id (UUID). (scope: read)

Create a draft journey in your property. Requires the 'write' scope. (scope: write)

Publish a journey version (activates it; clones draft nodes/edges to a published version). Requires the 'write' scope. (scope: write)

List interactive games (spin wheel, scratch card, trivia, etc.) in your property. (scope: read)

List Player Inbox messages in your property. (scope: read)

Send a Player Inbox broadcast to all or segmented inbox users. Requires the 'write' scope. (scope: write)

Pre-send compliance check for one or more phone numbers against the suppression list, DNC list, and active consent. (scope: read)

Record a TCPA consent event for a player on a channel, with full audit trail. Requires the 'write' scope. (scope: write)

Revoke consent for a player on a channel. Cascades to opt-out, DNC, and audit. Requires the 'write' scope. (scope: write)

Get the complete consent timeline for a player across all channels. (scope: pii)

Add a phone or email to the Do-Not-Contact list. Requires the 'write' scope. (scope: write)

List Do-Not-Contact entries for your property. (scope: read)

Export all data held for a player (CCPA/GDPR subject access request) across players, consent, sends, game plays, inbox, journeys, and suppression lists. (scope: pii)

Overview

What is PlayerOS?

PlayerOS is an MCP server for the PlayerOS casino marketing platform, providing AI agents with 25 tools and discoverable resources for managing player databases, multi-channel campaigns, journey automation, and TCPA/CCPA/GDPR compliance. It is exposed at https://api.playeros.ai/api/mcp alongside an official TypeScript/JavaScript SDK and CLI.

How to use PlayerOS?

AI agents connect to the MCP server at https://api.playeros.ai/api/mcp using the Model Context Protocol. For manual use, install the SDK with npm install @playeros/sdk, set the PLAYEROS_API_KEY environment variable (a property-scoped pk_... key from Settings → API & MCP), and import PlayerOS to call resources like players, campaigns, or compliance. A CLI command (playeros) is also available after installation, or via npx @playeros/sdk --help.

Key features of PlayerOS

  • Zero runtime dependencies; uses Node 18+ built-in fetch
  • Property-scoped API keys with read and/or write scopes
  • Idempotency support for campaign sends to prevent duplicates
  • Structured error handling with PlayerOSError and stable error codes
  • CLI outputs JSON for piping to tools like jq
  • MCP server with 25 tools and discoverable resources

Use cases of PlayerOS

  • List, create, update, and delete players from a unified gaming operator database
  • Send email or SMS campaigns with idempotency keys for reliable delivery
  • Check compliance (e.g., channel opt-in) and record player consent
  • Handle CCPA/GDPR data export or deletion requests
  • Manage property-scoped API keys and webhooks programmatically

FAQ from PlayerOS

What runtime is required for PlayerOS?

Node 18+ is required, as the SDK relies on the built-in fetch API and has zero external dependencies.

How do I authenticate with the PlayerOS MCP server?

Create a property-scoped API key (pk_…) in the PlayerOS dashboard under Settings → API & MCP. The key is sent as the X-Api-Key header; the SDK and CLI handle this automatically.

How does PlayerOS handle errors?

Non-2xx HTTP responses throw a PlayerOSError with a stable .code (e.g., insufficient_scope) and .status. The response also includes requestId and rateLimit hints; clients should back off on HTTP 429.

Can I use the PlayerOS CLI without installing it?

Yes, run npx @playeros/sdk --help to execute one-off commands without a permanent install.

Where is the MCP server hosted?

The MCP server is hosted at https://api.playeros.ai/api/mcp and its manifest is available at https://playeros.ai/.well-known/mcp.json.

Frequently asked questions

What runtime is required for PlayerOS?

Node 18+ is required, as the SDK relies on the built-in `fetch` API and has zero external dependencies.

How do I authenticate with the PlayerOS MCP server?

Create a property-scoped API key (`pk_…`) in the PlayerOS dashboard under Settings → API & MCP. The key is sent as the `X-Api-Key` header; the SDK and CLI handle this automatically.

How does PlayerOS handle errors?

Non-2xx HTTP responses throw a `PlayerOSError` with a stable `.code` (e.g., `insufficient_scope`) and `.status`. The response also includes `requestId` and `rateLimit` hints; clients should back off on HTTP 429.

Can I use the PlayerOS CLI without installing it?

Yes, run `npx @playeros/sdk --help` to execute one-off commands without a permanent install.

Where is the MCP server hosted?

The MCP server is hosted at `https://api.playeros.ai/api/mcp` and its manifest is available at `https://playeros.ai/.well-known/mcp.json`.

Comments

Basic information

Category

Developer Tools

Transports

stdio

Author

movaMedia-Inc

Submitted by

Justin Montgomery

More Developer Tools MCP servers

Raccha AI

Shree Mandadi

MCP-first toolbox for agents: namespaced key-value storage, a FIFO queue, auth, and a handful of stateless utility tools (JWT decode, hashing, cert inspection, CIDR math). Free while in early access. This repository is a

Routebase

Routebase

Routebase keeps your API's design, docs, contract tests, mocks and monitoring in one living OpenAPI spec so they can't drift apart. Agents work on that same source of truth, under your team's permissions.

Altronis

sypherin

MCP server + CLI for Altronis — Singapore AI consulting. Ask the Lyra consultant, generate a grant-matched AI transformation plan, pull curated SG AI events/news. Read-only, wraps altronis.sg.

Termany

thinkany-ai

Agent-Native Terminal

174

extentos

Asger mølgaard

Extentos is a multi-vendor development platform for adding smart-glasses capabilities to existing iOS and Android apps. The simplest analogy is Stripe for smart glasses: