Read, create or change an X Play
manage_x_playList X Plays, get one Play's current revision and audience, create a Buying intent Play, or update a Play's name, audience rules, sequence, or running/paused state. Each Play's audience is described in plain words (audience.sources); show those to the customer, never the plan JSON. create makes a Buying intent Play from one signal: competitor_followers (people following several competitor X accounts), competitor_post_engagers (people replying to, quoting or reposting competitors' recent posts), asks (people asking X and/or LinkedIn for a tool like the customer's), complaints (people unhappy with a competitor on X and/or LinkedIn), or reddit (threads asking for what the customer sells, with a reply drafted for review). When the customer has not named competitors, suggest a few from the company profile and confirm before creating. Phrases are short buyer words ("best bank for a startup", "account frozen"), never the company's own marketing terms. criteria says who fits in one sentence; found people are checked against it. A Buying intent Play collects before X is connected and lists people for review; it never enrolls or messages anyone by itself. sequenceId (an X-lane or LinkedIn-lane sequence) or message (creates an approved active X DM sequence named after the Play) is optional. Discover a Play first; update requires expectedRevision. Unspecified fields stay unchanged. The sender stays fixed. For Plays on the account's own posts or followers, reach_post_engagers sets up a new source. Pausing a Play stops future audience collection, not messages already queued in its sequence; use set_sequence_status to stop those too when requested. Enabling automatic enrollment or resuming may start future outreach through the paced engine. Never connects accounts or sends directly.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Required for create, e.g. "Founders who follow our competitors". | |
| plan | No | ||
| action | Yes | Required: list to discover Plays; get to read one; create for a new Buying intent Play; update to apply an explicit change. | |
| playId | No | Required for get and update. Discover with action=list. | |
| signal | No | Required for create. competitor_followers: people following several competitor X accounts (competitors, minShared). competitor_post_engagers: people replying to, quoting or reposting the competitors' recent X posts (competitors, postsPerCompetitor). asks: people asking X and/or LinkedIn for a tool like the customer's (phrases, networks). complaints: people unhappy with a competitor on X and/or LinkedIn (phrases, competitors for X, competitorNames for LinkedIn). reddit: Reddit threads asking for what the customer sells, with a reply drafted for review (phrases, subreddits). | |
| status | No | ||
| message | No | create: the first X DM; creates an approved active X DM sequence named after the Play. Optional; use sequenceId instead to reuse one. | |
| phrases | No | asks, complaints, reddit: 1–10 short search phrases in the words a buyer would write, e.g. "best bank for a startup" or "account frozen". | |
| criteria | No | create: who fits, in one sentence, e.g. "Founders or finance leads at early-stage US startups". Found people are checked against it. | |
| networks | No | asks, complaints: where to search. Default ["x"]. | |
| minShared | No | competitor_followers: how many of the competitors a person must follow. Default 3, never more than the number of competitors. | |
| sequenceId | No | create: an existing sequence to attach (X lane, or LinkedIn lane for a Buying intent Play). Optional. | |
| subreddits | No | reddit: subreddits to prefer, as r/name or name. Threads elsewhere on Reddit still count; omit to search all of Reddit. | |
| competitors | No | Competitor X accounts as @handle, handle or x.com profile link. 2–10 for competitor_followers, 1–10 for competitor_post_engagers, optional for complaints (anchors the X search). | |
| workspaceId | No | A teammate's workspace you may manage: an active workspace ID from list_team_workspaces. Omit for your own workspace. Supply on every call for a teammate. | |
| competitorNames | No | complaints on LinkedIn: competitor company names as written ("Mercury"), since LinkedIn posts name companies, not X handles. | |
| expectedRevision | No | Required for update. Copy the revision returned by list or get. | |
| postsPerCompetitor | No | competitor_post_engagers: newest posts read per competitor each day. Default 5. |