Servers Playground How we check Add a server Log in

Fictura

Working

co.fictura/mcpv0.1.2 Domain verified

Paywalls, onboarding, subscription analytics, A/B tests, attribution and errors for mobile apps.

Marketing & SEO

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.fictura.co/mcp

X-API-Key (optional)

Optional Fictura MCP key (fk_mcp_...) from Dashboard > Setup > Coding agents (MCP). Leave it out to sign in with your Fictura account (OAuth) instead.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

check_entitlement Read-only

The authoritative paid/not-paid verdict for one user, unified across Stripe, RevenueCat, App Store and Play — the same answer GET /api/v1/entitlements/{user_id} returns to a server. Note: `environment` is SANDBOX when the verdict rests on test purchases, so always check it before granting production access; a cancellation only flips will_renew (access runs to expires_at); and an unknown user is a valid 'none' answer, not an error.

user_idstring, required

Device id, account id or RevenueCat id

Fictura MCP server | mcptry

Fictura

Working

co.fictura/mcpv0.1.2 Domain verified

Paywalls, onboarding, subscription analytics, A/B tests, attribution and errors for mobile apps.

Marketing & SEO

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.fictura.co/mcp

X-API-Key (optional)

Optional Fictura MCP key (fk_mcp_...) from Dashboard > Setup > Coding agents (MCP). Leave it out to sign in with your Fictura account (OAuth) instead.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

check_entitlement Read-only

user_idstring, required

Device id, account id or RevenueCat id

Tools (44)

check_entitlement

read-only

Argument	Type	Description
user_id*	string	Device id, account id or RevenueCat id

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Device id, account id or RevenueCat id"
    }
  }
}

create_onboarding_draft

Creates a draft onboarding flow from a document you wrote (see get_onboarding_doc's reference). It is never made live: going live is done in the dashboard. Needs an MCP key that can edit.

Argument	Type	Description
doc*	object	A complete onboarding document
name*	string	The flow's name in the dashboard

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name",
    "doc"
  ],
  "properties": {
    "doc": {
      "type": "object",
      "description": "A complete onboarding document",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "name": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "The flow's name in the dashboard"
    }
  }
}

create_paywall_draft

Creates a draft paywall from a Studio template (template_key, from list_templates — the webview ones) or from a document you wrote. It is never made live: going live is done in the dashboard. Needs an MCP key that can edit.

Argument	Type	Description
doc	object	A complete document, instead of a template
name*	string	The paywall's name in the dashboard
template_key	string	A webview template key to start from

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "doc": {
      "type": "object",
      "description": "A complete document, instead of a template",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "name": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "The paywall's name in the dashboard"
    },
    "template_key": {
      "type": "string",
      "maxLength": 80,
      "description": "A webview template key to start from"
    }
  }
}

editor_get_doc

The document exactly as it is on the person's screen (unsaved changes included), which paywall it is, the screen they are on and the node they have selected, plus the document model reference. Read this before editor_set_doc and edit what you got — keep node ids, change only what was asked.

read-only

Argument	Type	Description
pairing_id*	string	From pair_editor

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "pairing_id"
  ],
  "properties": {
    "pairing_id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 8,
      "description": "From pair_editor"
    }
  }
}

editor_set_doc

Replaces the document in the person's open editor with the one given. It is NOT saved: the person sees the change, can undo it, and saves it themselves. The document is validated first and refused with the problems if it does not parse. Needs an MCP key that can edit.

destructive

Argument	Type	Description
doc*	object	The complete edited document
note	string	What changed, shown to the person in the editor
pairing_id*	string	From pair_editor

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "pairing_id",
    "doc"
  ],
  "properties": {
    "doc": {
      "type": "object",
      "description": "The complete edited document",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "note": {
      "type": "string",
      "maxLength": 160,
      "description": "What changed, shown to the person in the editor"
    },
    "pairing_id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 8,
      "description": "From pair_editor"
    }
  }
}

get_acquisition_report

`roas` gives per-campaign spend, attributed installs/trials/paying users, revenue, CPI, CAC and ROAS, plus blended totals and explicitly-unattributed revenue — always keep attributed and blended figures apart when reporting these. `spend` gives raw daily ad-spend rows. `links` lists this app's tracking links.

read-only

Argument	Type	Description
days	integer	Lookback, for view=spend
view*	string	Which acquisition view
since	string	YYYY-MM-DD, for view=roas
until	string	YYYY-MM-DD, for view=roas
provider	string	Filter, for view=spend

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "view"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 90,
      "minimum": 1,
      "description": "Lookback, for view=spend"
    },
    "view": {
      "enum": [
        "roas",
        "spend",
        "links"
      ],
      "type": "string",
      "description": "Which acquisition view"
    },
    "since": {
      "type": "string",
      "description": "YYYY-MM-DD, for view=roas"
    },
    "until": {
      "type": "string",
      "description": "YYYY-MM-DD, for view=roas"
    },
    "provider": {
      "type": "string",
      "description": "Filter, for view=spend"
    }
  }
}

get_analytics

This app's real numbers. `overview` gives headline metrics (users, trials, trial→paid rate, events by name, cancel reasons, 14-day activity). `funnel` gives the ordered conversion funnel with per-step drop-off. `cohorts` compares behaviour across billing outcomes — what converted users did that cancelled users didn't. Below ~100 users in a step the sample is too small to read. `stores` splits paying users, purchases and revenue by App Store / Google Play / web and by storefront country (last 28 days).

read-only

Argument	Type	Description
view*	string	Which analytics view to return

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "view"
  ],
  "properties": {
    "view": {
      "enum": [
        "overview",
        "funnel",
        "cohorts",
        "stores"
      ],
      "type": "string",
      "description": "Which analytics view to return"
    }
  }
}

get_app_setup

The real values needed to wire the Fictura SDK into a codebase: the API base URL, this app's publishable SDK key (gk_…), and the RevenueCat webhook URL. ALWAYS call this before generating integration code — never leave a placeholder API key in what you write. The SDK key is publishable and safe to commit in app source; it identifies the app, not a person.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

get_appsflyer_attribution_summary

What the AppsFlyer import brought in about where people came from: people with an imported attribution, split by media source (organic included) and acquisition vs retargeting, plus the top campaigns. Filters on the install date. Imported verdicts never overwrite an attribution Fictura's own SDK resolved. For revenue and ROAS by source, use get_attribution_report with view=kpis.

read-only

Argument	Type	Description
since	string	Install date from, YYYY-MM-DD
until	string	Install date to, YYYY-MM-DD
top_campaigns	integer	Default 20

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "since": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Install date from, YYYY-MM-DD"
    },
    "until": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Install date to, YYYY-MM-DD"
    },
    "top_campaigns": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Default 20"
    }
  }
}

get_appsflyer_import_status

Whether AppsFlyer is connected, the latest import run (status, progress, rows imported, duplicates skipped, people created, date range covered, error if it stopped), and whether an import has ever finished. Call before start_appsflyer_import so a finished import is not offered again as though nothing had happened.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

get_attribution_report

Where installs and revenue actually came from. `summary` is the headline attribution picture (installs, organic vs non-organic, revenue). `kpis` breaks the same window down by source, campaign, link or day. `installs` lists individual installs with their attribution. Defaults to the trailing 28 days.

read-only

Argument	Type	Description
view*	string	Which report to return
limit	integer	For view=installs (default 100)
since	string	YYYY-MM-DD (default 28 days ago)
until	string	YYYY-MM-DD (default today)
group_by	string	For view=kpis (default source)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "view"
  ],
  "properties": {
    "view": {
      "enum": [
        "summary",
        "kpis",
        "installs"
      ],
      "type": "string",
      "description": "Which report to return"
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "For view=installs (default 100)"
    },
    "since": {
      "type": "string",
      "description": "YYYY-MM-DD (default 28 days ago)"
    },
    "until": {
      "type": "string",
      "description": "YYYY-MM-DD (default today)"
    },
    "group_by": {
      "enum": [
        "source",
        "campaign",
        "link",
        "day"
      ],
      "type": "string",
      "description": "For view=kpis (default source)"
    }
  }
}

get_error_issue

One issue in full: the group, its 50 most recent occurrences with stack traces, release and environment, and 30 days of daily counts. This is the tool to reach for when asked to fix a production error. When the app uploaded source maps, each occurrence also has `stack_resolved` and `frames` (original file, line, column and function; `in_app` marks the app's own code) — read those instead of the minified `stack`. An occurrence with a trace_id can be opened with get_trace.

read-only

Argument	Type	Description
issue_id*	string	Issue id, from list_error_issues

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "issue_id"
  ],
  "properties": {
    "issue_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Issue id, from list_error_issues"
    }
  }
}

get_error_issue_brief

One issue condensed for fixing it: latest stack (resolved when source maps exist), in-app frames, breadcrumbs before it, facets (release, OS, device, screen), cause chain, and a ready-to-use fix prompt.

read-only

Argument	Type	Description
issue_id*	string	Issue id, from list_error_issues

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "issue_id"
  ],
  "properties": {
    "issue_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Issue id, from list_error_issues"
    }
  }
}

get_experiment

One experiment with its variants and full Bayesian results.

read-only

Argument	Type	Description
id*	string	Experiment id, from list_experiments

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Experiment id, from list_experiments"
    }
  }
}

get_link_infrastructure

How links reach the app. `app_links` is the most important for integration work: it returns the iOS team id, bundle id, Android package and SHA-256 fingerprints that Fictura serves in the Universal Links / App Links association files, plus ios_ready and android_ready. Get these wrong and BOTH files fail SILENTLY — they parse, associate nothing, report no error, and links simply keep opening the browser instead of the app, so verify the ready flags rather than assuming. `domains` lists branded link domains and their DNS verification state, `web_config` the web-to-app smart banner, `esp` the email provider link setup.

read-only

Argument	Type	Description
view*	string	Which part of the link setup

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "view"
  ],
  "properties": {
    "view": {
      "enum": [
        "app_links",
        "domains",
        "web_config",
        "esp"
      ],
      "type": "string",
      "description": "Which part of the link setup"
    }
  }
}

get_onboarding_doc

The JSON document a builder-made onboarding flow is made of, with its status and version, plus the reference to the document model. Read this before save_onboarding_doc, and edit the document you got rather than writing one from scratch — keep step keys and node ids, change only what was asked.

read-only

Argument	Type	Description
id*	string	The onboarding flow id, from list_surfaces

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The onboarding flow id, from list_surfaces"
    }
  }
}

get_paywall_doc

The JSON document a Studio (visual editor) paywall is made of, with its status and version, plus the reference to the document model. Read this before save_paywall_doc, and edit the document you got rather than writing one from scratch — keep node ids, change only what was asked. Prices are never typed: use {{ products.<slot>.price }} and the other product variables.

read-only

Argument	Type	Description
id*	string	The paywall id, from list_surfaces

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The paywall id, from list_surfaces"
    }
  }
}

get_push_config

Whether push is set up and who could receive it: registered-device counts per billing cohort (all / paid / trial / free) and whether OneSignal is configured. Returns counts and configuration only — never device tokens or individual recipients.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

get_setup_status

What is actually configured for this app: the setup checklist, every Fictura feature toggle and whether it is on, and which third-party integrations (Stripe, RevenueCat, Slack, Sentry, App Store Connect, …) are connected. Use it to check whether a feature is enabled before writing code that depends on it — a disabled tool is a server-side kill switch the SDK obeys.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

get_store_analytics

Store-reported numbers synced from Appfigures: downloads, re-downloads, updates, uninstalls, store revenue after the store's cut (subscriptions, in-app purchases, ads), top countries, the ratings snapshot, recent reviews with text, and category chart positions. Money is in micros of `currency`. Store revenue is a separate figure from RevenueCat revenue; never add the two. Returns connected: false when Appfigures is not set up.

read-only

Argument	Type	Description
days	integer	Lookback in days, default 28
reviews	integer	How many recent reviews to include, default 20

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 1095,
      "minimum": 1,
      "description": "Lookback in days, default 28"
    },
    "reviews": {
      "type": "integer",
      "maximum": 200,
      "minimum": 0,
      "description": "How many recent reviews to include, default 20"
    }
  }
}

get_surface

The full configuration of one paywall or onboarding flow, plus its version history. Note that configs never contain price strings — prices resolve at render time from the PurchasesAdapter's packages, so never copy a price literal out of (or into) a config.

read-only

Argument	Type	Description
id*	string	The surface id, from list_surfaces
kind*	string	Which kind of surface

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "kind",
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The surface id, from list_surfaces"
    },
    "kind": {
      "enum": [
        "paywall",
        "onboarding"
      ],
      "type": "string",
      "description": "Which kind of surface"
    }
  }
}

get_trace

Every span of one trace (app → backend → dependencies) as a tree: names, services, start offsets, durations, HTTP status and errors, plus the error events linked to the trace. Take the trace_id from an occurrence in get_error_issue. Use it to see where the time went or what failed first.

read-only

Argument	Type	Description
trace_id*	string	32-character hex W3C trace id

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "trace_id"
  ],
  "properties": {
    "trace_id": {
      "type": "string",
      "description": "32-character hex W3C trace id"
    }
  }
}

get_tracking_plan

Every event this app has ever sent, with volume, last-seen, and whether capture is switched off. Use it before adding instrumentation so you reuse the existing event name instead of introducing a near-duplicate — the name chosen here is the same string an experiment later names as its primary metric.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

get_user

One user's identity (every stitched device / account / RevenueCat id), event breakdown, churn state and recent activity. Accepts the Fictura master user id, or any identifier the app knows them by — a device id, account id or RevenueCat id.

read-only

Argument	Type	Description
user_id*	string	Master user id, or any known identifier

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "user_id"
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Master user id, or any known identifier"
    }
  }
}

list_campaigns

Campaigns read live from a connected ad platform: status, daily budget and ad sets. Returns a not_connected result rather than failing when the provider is not set up. This calls the provider's API, so prefer get_acquisition_report for historical numbers.

read-only

Argument	Type	Description
provider*	string	Which ad platform

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "provider"
  ],
  "properties": {
    "provider": {
      "enum": [
        "meta",
        "apple_search_ads",
        "snapchat",
        "tiktok",
        "google_ads",
        "reddit",
        "test"
      ],
      "type": "string",
      "description": "Which ad platform"
    }
  }
}

list_creators

Creator records with a 28-day funnel per creator (clicks, installs, trials, paying users) and the tracking links tagged to each.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

list_docs

The full documentation index — every page path, grouped by section, with a one-line description. Use it to find the right page when a search term is hard to guess. No API key required.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

list_error_issues

The error feed: grouped issues with level, status, event and user counts, a 14-day sparkline, plus the app's uptime summary. Defaults to unresolved issues only. `synthetic: true` marks console lines the SDK captured, not crashes.

read-only

Argument	Type	Description
status	string	Which issues to include (default unresolved)
include_legacy	boolean	Also list issues grouped before grouping v2 (default false)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "status": {
      "enum": [
        "unresolved",
        "resolved",
        "ignored",
        "discarded",
        "all"
      ],
      "type": "string",
      "description": "Which issues to include (default unresolved)"
    },
    "include_legacy": {
      "type": "boolean",
      "description": "Also list issues grouped before grouping v2 (default false)"
    }
  }
}

list_experiments

Every experiment with status and, for running or finished ones, full Bayesian results — exposures, conversions, and the probability each variant is best.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

list_store_products

This app's auto-renewable subscriptions in App Store Connect: product id, billing period and Apple review state. Use it to check that a paywall references a product that actually exists. Pass subscription_id to also fetch Apple's price ladder for that one product (Apple scopes price points per subscription, so there is no global list).

read-only

Argument	Type	Description
territory	string	Territory for price points (default USA)
subscription_id	string	Also return price points for this subscription

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "territory": {
      "type": "string",
      "description": "Territory for price points (default USA)"
    },
    "subscription_id": {
      "type": "string",
      "description": "Also return price points for this subscription"
    }
  }
}

list_surfaces

Every paywall and onboarding flow, what is actually being served at each placement (running experiment > live > none), and the valid placement names. IMPORTANT: read `placements` before writing a placement string into code. The list is configured ∪ observed, so a name that appears only under `observed` is usually a typo in the app — and a placement that does not exist renders nothing at all, with no error.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

list_templates

The one-click starter templates available for paywalls or onboarding flows, with the template key and what each looks like. Use this when asked to add a paywall so you pick a real template key rather than inventing one.

read-only

Argument	Type	Description
kind*	string	Which template catalog

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "kind"
  ],
  "properties": {
    "kind": {
      "enum": [
        "paywall",
        "onboarding"
      ],
      "type": "string",
      "description": "Which template catalog"
    }
  }
}

list_users

The app's users, most recently active first — each with an identity label, event count, last seen, and derived churn state (in_trial, converted, cancelled, expired, billing_issue, grace_period, paused, refunded, none). Capped so a large app does not flood the context; `total` reports how many matched before the cap.

read-only

Argument	Type	Description
limit	integer	Max users (default 50)
churn_state	string	Only users in this billing state

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Max users (default 50)"
    },
    "churn_state": {
      "enum": [
        "in_trial",
        "converted",
        "cancelled",
        "expired",
        "billing_issue",
        "grace_period",
        "paused",
        "refunded",
        "none"
      ],
      "type": "string",
      "description": "Only users in this billing state"
    }
  }
}

pair_editor

Connects to the paywall editor a person has open, using the 6-character code shown under “Pair an agent” in the Studio. Returns a pairing_id for the editor_* tools. The code works once and for 10 minutes; a pairing lasts 24 hours or until either side stops it.

Argument	Type	Description
code*	string	The code shown in the editor

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "maxLength": 12,
      "minLength": 4,
      "description": "The code shown in the editor"
    }
  }
}

read_doc

The complete markdown of one documentation page. Accepts a site-relative path such as '/implementation/welcome/sdk-quickstart' (a full docs.fictura.co URL works too). If the path is wrong, the closest real paths come back as suggestions. No API key required.

read-only

Argument	Type	Description
path*	string	Page path, e.g. /implementation/sdk-reference/expo-react-native

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1,
      "description": "Page path, e.g. /implementation/sdk-reference/expo-react-native"
    }
  }
}

save_onboarding_doc

Replaces a draft flow's document with the one given, as a new version (the dashboard's history shows it as `mcp: <note>` and can roll it back). Refused for a live flow. Needs an MCP key that can edit. Translations, overrides and the exit setting are kept.

destructive

Argument	Type	Description
id*	string	The draft flow's id
doc*	object	The complete edited document
note	string	What changed, for the version history

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id",
    "doc"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The draft flow's id"
    },
    "doc": {
      "type": "object",
      "description": "The complete edited document",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "note": {
      "type": "string",
      "maxLength": 160,
      "description": "What changed, for the version history"
    }
  }
}

save_paywall_doc

Replaces a draft paywall's document with the one given, as a new version (History in the dashboard shows it as `mcp: <note>` and can roll it back). Refused for a live paywall — copy it in the dashboard first. Needs an MCP key that can edit. Products, translations and other settings are kept.

destructive

Argument	Type	Description
id*	string	The draft paywall's id
doc*	object	The complete edited document
note	string	What changed, for the version history

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id",
    "doc"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The draft paywall's id"
    },
    "doc": {
      "type": "object",
      "description": "The complete edited document",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "note": {
      "type": "string",
      "maxLength": 160,
      "description": "What changed, for the version history"
    }
  }
}

search_docs

Full-text search across the Fictura docs, grouped by page. Use this before answering any 'how do I…' question about the SDK, API, paywalls, entitlements, links or webhooks — the docs are the source of truth and are regenerated on every code change. Returns page paths; pass one to read_doc for the full text. No API key required.

read-only

Argument	Type	Description
limit	integer	Max pages to return (default 8)
query*	string	What to search for, e.g. 'purchases adapter'

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Max pages to return (default 8)"
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "What to search for, e.g. 'purchases adapter'"
    }
  }
}

search_error_issues

Find issues by text in the title or culprit, platform, or release (first or last seen in). Returns the same rows as list_error_issues, filtered.

read-only

Argument	Type	Description
limit	integer
query	string	Text to look for in the title or culprit
status	string
release	string
platform	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "description": "Text to look for in the title or culprit"
    },
    "status": {
      "enum": [
        "unresolved",
        "resolved",
        "ignored",
        "discarded",
        "all"
      ],
      "type": "string"
    },
    "release": {
      "type": "string",
      "maxLength": 200
    },
    "platform": {
      "type": "string",
      "maxLength": 20
    }
  }
}

start_appsflyer_import

Import everything AppsFlyer holds for this app: installs and the channel, campaign, adset and ad behind each one, in-app events and purchases, uninstalls, reinstalls, ad revenue and retargeting traffic. All twelve raw-data reports are walked; ones the AppsFlyer plan lacks are skipped, not failed. Runs in the background and keeps going after this call. mode 'auto' (default) only pulls the days since the last finished import when there is one, and walks the full history otherwise. 'full' re-walks everything. resume=true continues a failed or cancelled run from where it stopped. Safe to call while a run is going: it reports that run instead of starting another. Anything already imported is counted once. Check progress with get_appsflyer_import_status.

Argument	Type	Description
mode	string	Default auto
resume	boolean	Continue the last failed or cancelled run

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "mode": {
      "enum": [
        "auto",
        "full"
      ],
      "type": "string",
      "description": "Default auto"
    },
    "resume": {
      "type": "boolean",
      "description": "Continue the last failed or cancelled run"
    }
  }
}

unpair_editor

Stops this pairing. The editor shows that the agent left.

Argument	Type	Description
pairing_id*	string	From pair_editor

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "pairing_id"
  ],
  "properties": {
    "pairing_id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 8,
      "description": "From pair_editor"
    }
  }
}

update_error_issue

Resolve, ignore or reopen an issue, assign it, set its priority, or add a note. Only works when the app allows MCP writes (Issues settings → Let MCP keys change issues).

Argument	Type	Description
note	string
status	string
assignee	any
issue_id*	string
priority	any
resolved_in_release	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "issue_id"
  ],
  "properties": {
    "note": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 1
    },
    "status": {
      "enum": [
        "resolved",
        "ignored",
        "ongoing"
      ],
      "type": "string"
    },
    "assignee": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ]
    },
    "issue_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "priority": {
      "anyOf": [
        {
          "enum": [
            "high",
            "medium",
            "low"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "resolved_in_release": {
      "type": "string",
      "maxLength": 200
    }
  }
}

validate_onboarding_doc

Runs a document through the same parser, step-key check and renderer a save uses and reports what is wrong, if anything. Changes nothing.

read-only

Argument	Type	Description
doc*	object	An onboarding document (version: 1)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "doc"
  ],
  "properties": {
    "doc": {
      "type": "object",
      "description": "An onboarding document (version: 1)",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  }
}

validate_paywall_doc

Runs a document through the same parser and renderer a save uses and reports what is wrong, if anything. Changes nothing.

read-only

Argument	Type	Description
doc*	object	A paywall document (version: 1)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "doc"
  ],
  "properties": {
    "doc": {
      "type": "object",
      "description": "A paywall document (version: 1)",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  }
}