Awesome MCP Servers by AI Anytime

Directory / Marketing, content & social

Fictura

Paywalls, onboarding, subscription analytics, A/B experiments, attribution and error reports for Expo and React Native apps; mostly read-only, OAuth sign-in or API key. Endpoint: https://mcp.fictura.co/mcp · Docs

Live  Answered an MCP handshake without credentials and listed 88 tools.

Category
Marketing, content & social
Transport
http
Source
https://github.com/Apex-Byte-Technologies/fictura-mcp
Endpoint
https://mcp.fictura.co/mcp
MCP Registry
co.fictura/mcp
Reports itself as
fictura 1.0.0
Protocol
2025-06-18
Tools
88
Context cost
about 19,814 tokens for the tool definitions (estimated at four characters per token)
Tool definitions last changed
no change seen since first check
Handshake time
204 ms
Repository
0 stars · last push 2026-11-03 · MIT
Last checked
2026-11-22 11:27:33 UTC
Listed since
2026-11-18

Health and compatibility

Endpoint reachableVerifiedResponded in 204 ms
MCP handshake (initialize)VerifiedCompleted without credentials
Tool discovery (tools/list)Verified88 tools listed
AuthenticationVerifiedNone needed to connect
Protocol versionVerified2025-06-18
TransportVerifiedStreamable HTTP
Capabilities declaredVerifiedprompts, tools

Last checked . Verified means the check saw it happen; it says nothing about whether the server is safe.

Recent history

5 daily checks so far; median response 159 ms. Green answered, violet asked for auth, red did not answer.

Set up in your client

Claude Code

Run this in a terminal:

claude mcp add --transport http fictura https://mcp.fictura.co/mcp

Claude Desktop

Open Settings → Connectors → Add custom connector and paste this URL:

https://mcp.fictura.co/mcp

Or bridge it through mcp-remote in claude_desktop_config.json (needs Node.js):

{
  "mcpServers": {
    "fictura": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.fictura.co/mcp"
      ]
    }
  }
}

Cursor

Add to Cursor

Or add it to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "fictura": {
      "url": "https://mcp.fictura.co/mcp"
    }
  }
}

VS Code

Add to VS Code

Or add it to .vscode/mcp.json:

{
  "servers": {
    "fictura": {
      "type": "http",
      "url": "https://mcp.fictura.co/mcp"
    }
  }
}

Or from a terminal:

code --add-mcp '{"name": "fictura", "type": "http", "url": "https://mcp.fictura.co/mcp"}'

Windsurf

Add it to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "fictura": {
      "serverUrl": "https://mcp.fictura.co/mcp"
    }
  }
}

Other clients

Most clients accept this shape. The endpoint is:

https://mcp.fictura.co/mcp
{
  "mcpServers": {
    "fictura": {
      "type": "http",
      "url": "https://mcp.fictura.co/mcp"
    }
  }
}

If it does not connect

Tools 88

Names, descriptions and input schemas exactly as the server returned them on 2026-11-22. This is the server author's own text. Nothing is run from this page. Labels such as read-only are declared by the server and are not verified. Raw JSON

check_entitlementread-onlyThe authoritative paid/not-paid verdict for one user, unified across Stripe, RevenueCat, App Store and Play — …

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.

ParameterTypeDescription
user_idstringrequiredDevice id, account id or RevenueCat id

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "check_entitlement",
    "arguments": {
      "user_id": "..."
    }
  }
}
compare_releasesread-onlyEvery route, screen and page seen in both releases, with count, p50, p95 and error rate in each, sorted by …

Every route, screen and page seen in both releases, with count, p50, p95 and error rate in each, sorted by the extra time per minute release b spends against a: what got slower or faster. Also what appears in only one of them. Take release names from list_releases or get_tracing_health; package@version+build works too, and a version alone is every build of it.

ParameterTypeDescription
astringrequiredThe earlier release
bstringrequiredThe later release
opstringoptionalOnly this op, like http.server or ui.load
rangestringoptionalWindow: 1h, 24h, 7d, 14d, 30d or 90d (default 24h). Ignored when from is given. One of: 1h, 24h, 7d, 14d, 30d, 90d
fromstringoptionalAn ISO time, or how long ago: 30m, 24h, 7d
tostringoptionalAn ISO time, or how long ago (default now)
environmentstringoptionalLike production. Default: production when the app has it, else its busiest non-development one. 'all' for every environment.
releasestringoptionalOnly this release: 2.0.77+185, 2.0.77 (every build) or package@2.0.77+185
servicestringoptionalOnly this service, like house-ai-api or the app's bundle id
sourcestringoptionalbackend (servers), frontend (app and web), or all (default) One of: backend, frontend, all

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "compare_releases",
    "arguments": {
      "a": "...",
      "b": "..."
    }
  }
}
create_experimentcan modifyCreate an A/B test as a DRAFT: nobody sees it until start_experiment. 2 to 4 arms, each pointing at a paywall …

Create an A/B test as a DRAFT: nobody sees it until start_experiment. 2 to 4 arms, each pointing at a paywall or onboarding flow of this app on the experiment's surface (ids from list_surfaces); one arm may be a holdout with no target (it keeps the live config). Exactly one control; the first arm when none is marked. Defaults: mode notify (report the winner, don't ship it), new users only, the default placement, trial_started as the metric. Only works when the app allows MCP writes.

ParameterTypeDescription
namestringrequired
hypothesisstringoptionalWhat you expect to happen and why
surfacestringrequiredOne of: paywall, onboarding
placementstringoptionalPlacement id (letters, digits, _ or -). Default `default`
primary_metricstringoptionalDefault trial_started
experiment_typestringoptionalA label. Default other One of: design, price_point, introductory_offer, free_trial_offer, subscription_duration, subscription_ordering, other
min_confidencenumberoptionalChance to be best a winner needs. Default 0.95
modestringoptionalnotify (default) reports a winner; auto ships it One of: notify, auto
audience_pctintegeroptional% of eligible users enrolled. Default 100
enrollmentstringoptionalDefault new: users first seen after the start One of: new, new_and_existing
targetingobjectoptionalWho is eligible; every rule must pass, {} = everyone. Keys: countries (ISO-2), platforms (ios, android, web), app_version_min/max, days_since_install_min/max, billing_states, custom
priorityintegeroptionalEnrollment order, lowest first. Default 100
is_qabooleanoptionalA QA run on test builds. Default false
variantsobject[]required

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_experiment",
    "arguments": {
      "name": "...",
      "surface": "paywall",
      "variants": []
    }
  }
}
create_fix_prcan modifyexternal accessOpen your fix for an issue as a draft PR in the app's repo, with `Fixes <short id>` so the issue resolves …

Open your fix for an issue as a draft PR in the app's repo, with `Fixes <short id>` so the issue resolves when it ships. Send patches (git diff) per file. No build, CI or .github changes. Needs "Let MCP keys open pull requests".

ParameterTypeDescription
issue_idstringrequired
titlestringoptional
root_causestringrequired
summarystringrequiredWhat the change does
tests_runstringoptional
filesobject[]required

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_fix_pr",
    "arguments": {
      "issue_id": "...",
      "root_cause": "...",
      "summary": "...",
      "files": []
    }
  }
}
create_inbound_filtercan modifyDrop matching errors at ingest from now on (within 30 seconds): counted, never stored, grouped or alerted on. …

Drop matching errors at ingest from now on (within 30 seconds): counted, never stored, grouped or alerted on. Use it for noise nobody will fix. Kinds as in list_inbound_filters; environment `simulator` drops events from simulators and emulators. Refuses an exact duplicate. Only works when the app allows MCP writes.

ParameterTypeDescription
kindstringrequiredOne of: exc_type, message, environment, release
patternstringrequiredExact text, or for message a glob like *RevenueCat*network*

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_inbound_filter",
    "arguments": {
      "kind": "exc_type",
      "pattern": "..."
    }
  }
}
create_onboarding_draftcan modifyCreates a draft onboarding flow from a document you wrote (see get_onboarding_doc's reference). It is never …

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.

ParameterTypeDescription
namestringrequiredThe flow's name in the dashboard
docobjectrequiredA complete onboarding document

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_onboarding_draft",
    "arguments": {
      "name": "...",
      "doc": {}
    }
  }
}
create_paywall_draftcan modifyCreates a draft paywall from a Studio template (template_key, from list_templates — the webview ones) or from …

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.

ParameterTypeDescription
namestringrequiredThe paywall's name in the dashboard
template_keystringoptionalA webview template key to start from
docobjectoptionalA complete document, instead of a template

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_paywall_draft",
    "arguments": {
      "name": "..."
    }
  }
}
create_pull_requestcan modifyexternal accessOpen any change as a draft PR on a new branch in one of the repos connected to Fictura. Optionally tie it to …

Open any change as a draft PR on a new branch in one of the repos connected to Fictura. Optionally tie it to an issue. Nothing under .github/. Needs "Let MCP keys open pull requests".

ParameterTypeDescription
repostringrequiredowner/repo
basestringoptionalTarget branch; default: the repo's default branch
titlestringrequired
bodystringrequired
issue_idstringoptional
filesobject[]required

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_pull_request",
    "arguments": {
      "repo": "...",
      "title": "...",
      "body": "...",
      "files": []
    }
  }
}
create_ticketcan modifyexternal accessCreate a ticket for an error issue in GitHub Issues, Linear or Jira (connected on the Tools tab). The body is …

Create a ticket for an error issue in GitHub Issues, Linear or Jira (connected on the Tools tab). The body is short and redacted. One GitHub issue per error issue. Only works when the app allows MCP writes.

ParameterTypeDescription
issue_idstringrequired
providerstringrequiredOne of: github, linear, jira

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_ticket",
    "arguments": {
      "issue_id": "...",
      "provider": "github"
    }
  }
}
create_tracking_linkcan modifyCreates a tracking link and returns its shareable URL. A tap is logged as a click, then redirected to …

Creates a tracking link and returns its shareable URL. A tap is logged as a click, then redirected to destination_url with the click's id, which is how an install is credited to the link. A tap from a computer goes to desktop_url instead, or to the app's website when destination_url is a store page. Use the store address for a real campaign, or the app's own scheme (myapp://) for a link that opens the app in a test. Creates a new link each time; nothing existing changes. Needs read and edit access.

ParameterTypeDescription
namestringrequiredWhat the link is for, shown on the Links page
destination_urlstringrequiredWhere a tap goes: a store address, a web page or myapp://
slugstringoptionalVanity slug, 3 to 50 letters and digits. Leave out for a random one.
providerstringoptionalMedia source in lowercase, like tiktok
campaign_idstringoptionalCampaign name or id
deep_link_valuestringoptionalWhere in the app to send the person
play_store_urlstringoptionalGoogle Play address, for the install referrer
desktop_urlstringoptionalWhere a tap from a computer goes. Leave out to use the app's website

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_tracking_link",
    "arguments": {
      "name": "...",
      "destination_url": "..."
    }
  }
}
delete_inbound_filtercan modifydestructiveStop dropping what one inbound filter matches; new events land again within 30 seconds. Events it already …

Stop dropping what one inbound filter matches; new events land again within 30 seconds. Events it already dropped are not recovered. Take the id from list_inbound_filters. Only works when the app allows MCP writes.

ParameterTypeDescription
filter_idstringrequiredFilter id, from list_inbound_filters

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "delete_inbound_filter",
    "arguments": {
      "filter_id": "..."
    }
  }
}
editor_get_docread-onlyThe document exactly as it is on the person's screen (unsaved changes included), which paywall it is, the …

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.

ParameterTypeDescription
pairing_idstringrequiredFrom pair_editor

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "editor_get_doc",
    "arguments": {
      "pairing_id": "..."
    }
  }
}
editor_set_doccan modifydestructiveReplaces the document in the person's open editor with the one given. It is NOT saved: the person sees the …

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.

ParameterTypeDescription
pairing_idstringrequiredFrom pair_editor
docobjectrequiredThe complete edited document
notestringoptionalWhat changed, shown to the person in the editor

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "editor_set_doc",
    "arguments": {
      "pairing_id": "...",
      "doc": {}
    }
  }
}
get_acquisition_reportread-only`roas` gives per-campaign spend, installs (install_at in the range, split exact / weak / modelled, …

`roas` gives per-campaign spend, installs (install_at in the range, split exact / weak / modelled, fraud-flagged kept out of CPI), trials, paying users, cohort revenue (paid in the range by installs from the range), CPI, CAC and ROAS = net cohort revenue ÷ spend — the same numbers as get_attribution_report kpis grouped by campaign. `blended` is the whole app by payment date and `unattributed` the part of it with no source; always keep attributed and blended figures apart. Money is per currency (no conversion). Default range: the last 28 days in the app's time zone. `spend` gives raw daily ad-spend rows. `links` lists this app's tracking links.

ParameterTypeDescription
viewstringrequiredWhich acquisition view One of: roas, spend, links
sincestringoptionalYYYY-MM-DD, for view=roas
untilstringoptionalYYYY-MM-DD, for view=roas
providerstringoptionalFilter, for view=spend
daysintegeroptionalLookback, for view=spend

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_acquisition_report",
    "arguments": {
      "view": "roas"
    }
  }
}
get_ai_usageread-onlyModel calls by model (gen_ai spans): calls, per minute, error rate, p50 to p99, total time, input and output …

Model calls by model (gen_ai spans): calls, per minute, error rate, p50 to p99, total time, input and output tokens; and MCP tool calls by tool (mcp.server spans). Prompt and completion text is never stored, so it is never here.

ParameterTypeDescription
rangestringoptionalWindow: 1h, 24h, 7d, 14d, 30d or 90d (default 24h). Ignored when from is given. One of: 1h, 24h, 7d, 14d, 30d, 90d
fromstringoptionalAn ISO time, or how long ago: 30m, 24h, 7d
tostringoptionalAn ISO time, or how long ago (default now)
environmentstringoptionalLike production. Default: production when the app has it, else its busiest non-development one. 'all' for every environment.
releasestringoptionalOnly this release: 2.0.77+185, 2.0.77 (every build) or package@2.0.77+185
servicestringoptionalOnly this service, like house-ai-api or the app's bundle id
sourcestringoptionalbackend (servers), frontend (app and web), or all (default) One of: backend, frontend, all

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_ai_usage",
    "arguments": {}
  }
}
get_analyticsread-onlyThis app's real numbers. `overview` gives headline metrics (users, trials, trial→paid rate, events by name, …

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).

ParameterTypeDescription
viewstringrequiredWhich analytics view to return One of: overview, funnel, cohorts, stores

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_analytics",
    "arguments": {
      "view": "overview"
    }
  }
}
get_app_setupread-onlyThe real values needed to wire the Fictura SDK into a codebase: the API base URL, this app's publishable SDK …

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.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_app_setup",
    "arguments": {}
  }
}
get_appsflyer_attribution_summaryread-onlyWhat the AppsFlyer import brought in about where people came from: people with an imported attribution, split …

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.

ParameterTypeDescription
sincestringoptionalInstall date from, YYYY-MM-DD
untilstringoptionalInstall date to, YYYY-MM-DD
top_campaignsintegeroptionalDefault 20

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_appsflyer_attribution_summary",
    "arguments": {}
  }
}
get_appsflyer_import_statusread-onlyWhether AppsFlyer is connected, the latest import run (status, progress, rows imported, duplicates skipped, …

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.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_appsflyer_import_status",
    "arguments": {}
  }
}
get_attribution_reportread-onlyWhere installs and revenue came from, on the same definitions as the dashboard and the API. An install is a …

Where installs and revenue came from, on the same definitions as the dashboard and the API. An install is a device's first SDK launch (install_at) in the range; server-only users are never installs. Non-organic = installs with an attribution that is exact (store referrer, Apple Ads, claimed or opened link, clipboard, code, product page, ad id), weak (UTM only) or modelled (Android/web IP match within 60 minutes; never iOS), not retargeting and not fraud-flagged; organic = installs − non_organic − fraud_flagged. Installs from test sources are left out (count in test_installs) unless include_test is true. `summary`: totals, exact_installs / weak_installs / modelled_installs, exact_match_rate, fraud_flagged, reinstalls, CVR (installs whose winning touch is a /l click ÷ unique non-bot /l clicks), weighted D1/D7 retention, revenue by PAYMENT date (`revenue`, per currency), by_platform, rules_changed_at (when the current counting rules began; numbers before it were counted under the old rules and are not recomputed) and time_zone. `kpis`: the same split per source / campaign / link / day / platform, with spend, cohort revenue (paid in the range by installs from the range) and ROAS = net cohort revenue ÷ spend; revenue_by_payment_date is the separate payment-date figure. `installs`: individual installs with match_type, match_kind, confidence, fraud_rule and is_reinstall. `accuracy`: exact-match rate by day, platform and link, and how often a modelled guess was later replaced by an …

ParameterTypeDescription
viewstringrequiredWhich report to return One of: summary, kpis, installs, accuracy
sincestringoptionalYYYY-MM-DD, first day (default: until − 27 days)
untilstringoptionalYYYY-MM-DD, last day (default: today in the app's time zone)
group_bystringoptionalFor view=kpis (default source) One of: source, campaign, link, day, platform
limitintegeroptionalFor view=installs (default 100)
include_testbooleanoptionalKeep installs from test sources (default false)

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_attribution_report",
    "arguments": {
      "view": "summary"
    }
  }
}
get_endpoint_summaryread-onlyEverything about one row of the Performance page, to answer 'why is this slow?': count, error rate, p50 to …

Everything about one row of the Performance page, to answer 'why is this slow?': count, error rate, p50 to p99 and the change against the window before; where the time goes inside each request (database, HTTP and model calls, and the backend routes a screen waited on); what the slowest 10% have that the rest don't (release, status, device…) and which inner spans grow most in them; who calls a dependency; per-release numbers; sample traces (slowest, typical, fastest, failed: open them with get_trace); and the open issues on that route. op is like http.server, ui.load, ui.pageload, http.client, db, gen_ai, task; route is the route, screen, page, host or table as get_performance_overview lists it.

ParameterTypeDescription
opstringrequiredThe row's op, like http.server
routestringrequiredThe row's route, screen, page, host or table
rangestringoptionalWindow: 1h, 24h, 7d, 14d, 30d or 90d (default 24h). Ignored when from is given. One of: 1h, 24h, 7d, 14d, 30d, 90d
fromstringoptionalAn ISO time, or how long ago: 30m, 24h, 7d
tostringoptionalAn ISO time, or how long ago (default now)
environmentstringoptionalLike production. Default: production when the app has it, else its busiest non-development one. 'all' for every environment.
releasestringoptionalOnly this release: 2.0.77+185, 2.0.77 (every build) or package@2.0.77+185
servicestringoptionalOnly this service, like house-ai-api or the app's bundle id
sourcestringoptionalbackend (servers), frontend (app and web), or all (default) One of: backend, frontend, all

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_endpoint_summary",
    "arguments": {
      "op": "...",
      "route": "..."
    }
  }
}
get_error_eventread-onlyOne occurrence: frames with source lines and variables, request, tags, contexts, breadcrumbs, causes and …

One occurrence: frames with source lines and variables, request, tags, contexts, breadcrumbs, causes and trace id. Pass issue_id for its latest event, or event_id. Use it to see why one error happened. Long events give up variables, then library frames, then breadcrumbs, and `truncated` says what went: call again with section to read that part whole.

ParameterTypeDescription
issue_idstringoptionalRead this issue's latest event
event_idstringoptionalRead this event, from search_error_events or get_error_issue
sectionstringoptionalRead one part whole instead of the whole event One of: frames, breadcrumbs, request, contexts, causes, stack, native
limitintegeroptionalRows, for frames, breadcrumbs and causes (default 100)
cursorstringoptionalnext_cursor, for frames, breadcrumbs and causes

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_error_event",
    "arguments": {}
  }
}
get_error_issueread-onlyOne issue with its status, history, 30 days of daily counts and recent occurrences. The newest occurrence has …

One issue with its status, history, 30 days of daily counts and recent occurrences. The newest occurrence has its stack and frames, the older ones are one-line summaries. Use it to see how an issue behaves over time. For a fix, get_error_issue_brief is shorter; for source lines and variables, use get_error_event.

ParameterTypeDescription
issue_idstringrequiredIssue id, from list_error_issues
occurrencesintegeroptionalHow many recent occurrences (default 5)

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_error_issue",
    "arguments": {
      "issue_id": "..."
    }
  }
}
get_error_issue_briefread-onlyUse this first when asked to fix an error. One issue condensed: in-app frames with their source lines, the …

Use this first when asked to fix an error. One issue condensed: in-app frames with their source lines, the request, tags, breadcrumbs before it, log lines from the same trace, facets (release, OS, device, route), cause chain, and a ready-to-use fix prompt.

ParameterTypeDescription
issue_idstringrequiredIssue id, from list_error_issues

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_error_issue_brief",
    "arguments": {
      "issue_id": "..."
    }
  }
}
get_error_settingsread-onlyThis app's error settings (auto-resolve days, built-in noise rules, crash-free threshold, digest, code links, …

This app's error settings (auto-resolve days, built-in noise rules, crash-free threshold, digest, code links, retention, whether MCP may write) and tracing settings (sample rate, hosts that get trace headers). connection_can_write says whether this connection's write tools will work.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_error_settings",
    "arguments": {}
  }
}
get_event_analyticsread-onlyOne tab of the dashboard's Events page with the exact numbers behind it. overview: totals against the …

One tab of the dashboard's Events page with the exact numbers behind it. overview: totals against the previous period and every event with users, count, previous count, worked and failed, plus key events. screens: views, users and time per screen. taps: taps per screen and element. broken_taps: dead and rage taps. sessions: length, bounce, entry and exit screens, platforms, versions, recent sessions. devices: app version, OS, model, country, locale and more. Days are in UTC. Tables are capped at 60 rows.

ParameterTypeDescription
viewstringrequiredOne of: overview, screens, taps, broken_taps, sessions, devices
rangestringoptionalOne of: 24h, 7d, 30d, 90d

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_event_analytics",
    "arguments": {
      "view": "overview"
    }
  }
}
get_experimentread-onlyOne experiment with its variants and full Bayesian results.

One experiment with its variants and full Bayesian results.

ParameterTypeDescription
idstringrequiredExperiment id, from list_experiments

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_experiment",
    "arguments": {
      "id": "..."
    }
  }
}
get_fix_runread-onlyA fix run's status, root cause, plan, files, tests, cost so far, and its pull request.

A fix run's status, root cause, plan, files, tests, cost so far, and its pull request.

ParameterTypeDescription
run_idstringrequired

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_fix_run",
    "arguments": {
      "run_id": "..."
    }
  }
}
get_issue_activityread-onlyWhat people and Fictura did to one issue, newest first: status changes, assignments, priority, notes with …

What people and Fictura did to one issue, newest first: status changes, assignments, priority, notes with their text, tickets, regressions. Use it before changing an issue, to see who already looked at it.

ParameterTypeDescription
issue_idstringrequiredIssue id, from list_error_issues
limitintegeroptionalRows (default 25)
cursorstringoptionalnext_cursor from the last answer

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_issue_activity",
    "arguments": {
      "issue_id": "..."
    }
  }
}
get_issue_tag_valuesread-onlyHow often each value of one tag or facet appears on one issue in the last 30 days. Use it to see where an …

How often each value of one tag or facet appears on one issue in the last 30 days. Use it to see where an issue concentrates: which release, route, device, logger or person. Leave out key to list the keys there are.

ParameterTypeDescription
issue_idstringrequiredIssue id, from list_error_issues
keystringoptionalA facet (release, route, environment, level, device, os_version, handled, mechanism, logger, user) or any tag name
limitintegeroptionalValues (default 25)
cursorstringoptionalnext_cursor from the last answer

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_issue_tag_values",
    "arguments": {
      "issue_id": "..."
    }
  }
}
get_jobsread-onlyWork done outside requests: background tasks, queue publish and process, and cron runs, with counts, failures …

Work done outside requests: background tasks, queue publish and process, and cron runs, with counts, failures and timings; each cron with its last run, its usual gap, and late: true when it has not run for twice that gap.

ParameterTypeDescription
rangestringoptionalWindow: 1h, 24h, 7d, 14d, 30d or 90d (default 24h). Ignored when from is given. One of: 1h, 24h, 7d, 14d, 30d, 90d
fromstringoptionalAn ISO time, or how long ago: 30m, 24h, 7d
tostringoptionalAn ISO time, or how long ago (default now)
environmentstringoptionalLike production. Default: production when the app has it, else its busiest non-development one. 'all' for every environment.
releasestringoptionalOnly this release: 2.0.77+185, 2.0.77 (every build) or package@2.0.77+185
servicestringoptionalOnly this service, like house-ai-api or the app's bundle id
sourcestringoptionalbackend (servers), frontend (app and web), or all (default) One of: backend, frontend, all

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_jobs",
    "arguments": {}
  }
}
get_link_infrastructureread-onlyHow links reach the app. `app_links` is the most important for integration work: it returns the iOS team id, …

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.

ParameterTypeDescription
viewstringrequiredWhich part of the link setup One of: app_links, domains, web_config, esp

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_link_infrastructure",
    "arguments": {
      "view": "app_links"
    }
  }
}
get_mobile_vitalsread-onlyThe mobile app's vitals from real devices: cold (and warm) app start, time to initial display (ttid) and full …

The mobile app's vitals from real devices: cold (and warm) app start, time to initial display (ttid) and full display (ttfd), slow and frozen frame percentages, and JS stall time; overall, per screen (busiest first) and per release. Each with p50, p75, p95 and the sample count. platform ios, android or both (default).

ParameterTypeDescription
platformstringoptionalOne of: ios, android, both
rangestringoptionalWindow: 1h, 24h, 7d, 14d, 30d or 90d (default 24h). Ignored when from is given. One of: 1h, 24h, 7d, 14d, 30d, 90d
fromstringoptionalAn ISO time, or how long ago: 30m, 24h, 7d
tostringoptionalAn ISO time, or how long ago (default now)
environmentstringoptionalLike production. Default: production when the app has it, else its busiest non-development one. 'all' for every environment.
releasestringoptionalOnly this release: 2.0.77+185, 2.0.77 (every build) or package@2.0.77+185
servicestringoptionalOnly this service, like house-ai-api or the app's bundle id
sourcestringoptionalbackend (servers), frontend (app and web), or all (default) One of: backend, frontend, all

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_mobile_vitals",
    "arguments": {}
  }
}
get_onboarding_docread-onlyThe JSON document a builder-made onboarding flow is made of, with its status and version, plus the reference …

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.

ParameterTypeDescription
idstringrequiredThe onboarding flow id, from list_surfaces

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_onboarding_doc",
    "arguments": {
      "id": "..."
    }
  }
}
get_paywall_docread-onlyThe JSON document a Studio (visual editor) paywall is made of, with its status and version, plus the …

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.

ParameterTypeDescription
idstringrequiredThe paywall id, from list_surfaces

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_paywall_doc",
    "arguments": {
      "id": "..."
    }
  }
}
get_performance_overviewread-onlyHow fast the app is right now, backend and frontend: backend requests per minute, p95 and error rate against …

How fast the app is right now, backend and frontend: backend requests per minute, p95 and error rate against the window before; screen and page load times; then the routes that take the most total time, the slowest screens and pages, and the slowest dependencies (HTTP hosts, database tables). Start here, then open one with get_endpoint_summary.

ParameterTypeDescription
rangestringoptionalWindow: 1h, 24h, 7d, 14d, 30d or 90d (default 24h). Ignored when from is given. One of: 1h, 24h, 7d, 14d, 30d, 90d
fromstringoptionalAn ISO time, or how long ago: 30m, 24h, 7d
tostringoptionalAn ISO time, or how long ago (default now)
environmentstringoptionalLike production. Default: production when the app has it, else its busiest non-development one. 'all' for every environment.
releasestringoptionalOnly this release: 2.0.77+185, 2.0.77 (every build) or package@2.0.77+185
servicestringoptionalOnly this service, like house-ai-api or the app's bundle id
sourcestringoptionalbackend (servers), frontend (app and web), or all (default) One of: backend, frontend, all

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_performance_overview",
    "arguments": {}
  }
}
get_pull_request_statusread-onlyThe PRs tied to an issue (opened by Fictura or linked), with state, draft, CI checks, merge and the release …

The PRs tied to an issue (opened by Fictura or linked), with state, draft, CI checks, merge and the release that shipped it.

ParameterTypeDescription
issue_idstringrequired

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_pull_request_status",
    "arguments": {
      "issue_id": "..."
    }
  }
}
get_push_configread-onlyWhether push is set up and who could receive it: registered-device counts per billing cohort (all / paid / …

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.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_push_config",
    "arguments": {}
  }
}
get_setup_statusread-onlyWhere this app has got to: the six setup steps and which are really done, worked out from data that has …

Where this app has got to: the six setup steps and which are really done, worked out from data that has arrived, then the billing state, every Fictura feature toggle and whether it is on, and which third-party integrations (Stripe, RevenueCat, Slack, App Store Connect, …) are connected. Use it to check a setup step worked, and to check a feature is enabled before writing code that depends on it — a disabled tool is a server-side kill switch the SDK obeys.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_setup_status",
    "arguments": {}
  }
}
get_setup_stepread-onlyWhat to do for one of Fictura's six setup steps, ready to follow: the instructions, this app's real values …

What to do for one of Fictura's six setup steps, ready to follow: the instructions, this app's real values (so there is nothing to fill in), the full text of that step's docs pages, and how to check it worked. Call this when a person pastes a setup prompt, and follow what it returns rather than recalling the SDK from memory. Steps in order: install, connect, events, attribution, errors, performance.

ParameterTypeDescription
stepstringrequiredWhich step One of: install, connect, events, attribution, errors, performance

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_setup_step",
    "arguments": {
      "step": "install"
    }
  }
}
get_spanread-onlyOne span in full: name, op, service, timing, status, every attribute, the errors that happened in it, and the …

One span in full: name, op, service, timing, status, every attribute, the errors that happened in it, and the log lines written while it ran. Take the trace_id and span_id from get_trace.

ParameterTypeDescription
trace_idstringrequired32-character hex W3C trace id
span_idstringrequired16-character hex span id

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_span",
    "arguments": {
      "trace_id": "...",
      "span_id": "..."
    }
  }
}
get_store_analyticsread-onlyStore-reported numbers synced from Appfigures: downloads, re-downloads, updates, uninstalls, store revenue …

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.

ParameterTypeDescription
daysintegeroptionalLookback in days, default 28
reviewsintegeroptionalHow many recent reviews to include, default 20

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_store_analytics",
    "arguments": {}
  }
}
get_surfaceread-onlyThe configuration of one paywall or onboarding flow, plus its version history (version, note, date). A served …

The configuration of one paywall or onboarding flow, plus its version history (version, note, date). A served design's compiled html is left out (html_bytes gives its size) and a Studio doc shows as doc: true; read the design with get_paywall_doc or get_onboarding_doc. 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.

ParameterTypeDescription
kindstringrequiredWhich kind of surface One of: paywall, onboarding
idstringrequiredThe surface id, from list_surfaces

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_surface",
    "arguments": {
      "kind": "paywall",
      "id": "..."
    }
  }
}
get_traceread-onlyOne trace (app → backend → dependencies) as a tree: names, services, start offsets, durations, HTTP status …

One trace (app → backend → dependencies) as a tree: names, services, start offsets, durations, HTTP status and errors, plus the error events linked to it. Take the trace_id from an event or from search_traces. Use it to see where the time went or what failed first. Long traces page with next_cursor.

ParameterTypeDescription
trace_idstringrequired32-character hex W3C trace id
limitintegeroptionalSpans (default 100)
cursorstringoptionalnext_cursor from the last answer

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_trace",
    "arguments": {
      "trace_id": "..."
    }
  }
}
get_tracing_healthread-onlyWho is sending traces in the last 24 hours: each service with its SDK and version, frontend or backend, last …

Who is sending traces in the last 24 hours: each service with its SDK and version, frontend or backend, last span, span count, average sample rate and environments; how many of the app's traces reached a backend (joined traces: zero means the app is not sending traceparent to the API, or the backend is not traced); what span ingest refused per day this week (invalid, rate limited, over the daily quota); and what the SDKs say they dropped before sending (sdk_dropped: errors, logs, traces or sessions, by reason: queue_full, rejected, unsendable). The first tool to call when performance data or errors look missing.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_tracing_health",
    "arguments": {}
  }
}
get_tracking_planread-onlyEvery event this app has ever sent, with volume, last-seen, and whether capture is switched off. Use it …

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.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_tracking_plan",
    "arguments": {}
  }
}
get_uptime_monitorread-onlyThe URL Fictura pings every minute for this app, whether it is up or down, the last check, consecutive …

The URL Fictura pings every minute for this app, whether it is up or down, the last check, consecutive failures, when the current downtime started, and availability over 24 hours and 7 days. monitor is null when none is set.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_uptime_monitor",
    "arguments": {}
  }
}
get_userread-onlyOne user's identity (every stitched device / account / RevenueCat id), event breakdown, churn state and …

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.

ParameterTypeDescription
user_idstringrequiredMaster user id, or any known identifier

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_user",
    "arguments": {
      "user_id": "..."
    }
  }
}
get_web_vitalsread-onlyThe web app's Core Web Vitals from real browsers: a 0 to 100 performance score (LCP 30%, INP 30%, CLS 15%, …

The web app's Core Web Vitals from real browsers: a 0 to 100 performance score (LCP 30%, INP 30%, CLS 15%, FCP 15%, TTFB 10%, Google's thresholds), each vital's p75 with its good / needs improvement / poor counts, and pages ranked by opportunity (how much the score would rise if that page scored 100).

ParameterTypeDescription
rangestringoptionalWindow: 1h, 24h, 7d, 14d, 30d or 90d (default 24h). Ignored when from is given. One of: 1h, 24h, 7d, 14d, 30d, 90d
fromstringoptionalAn ISO time, or how long ago: 30m, 24h, 7d
tostringoptionalAn ISO time, or how long ago (default now)
environmentstringoptionalLike production. Default: production when the app has it, else its busiest non-development one. 'all' for every environment.
releasestringoptionalOnly this release: 2.0.77+185, 2.0.77 (every build) or package@2.0.77+185
servicestringoptionalOnly this service, like house-ai-api or the app's bundle id
sourcestringoptionalbackend (servers), frontend (app and web), or all (default) One of: backend, frontend, all

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_web_vitals",
    "arguments": {}
  }
}
link_pull_requestcan modifyexternal accessTie an existing GitHub PR (by URL) to an issue. When it merges, Fictura resolves the issue in the release …

Tie an existing GitHub PR (by URL) to an issue. When it merges, Fictura resolves the issue in the release that ships it. Only works when the app allows MCP writes.

ParameterTypeDescription
issue_idstringrequired
urlstringrequiredhttps://github.com/owner/repo/pull/123

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "link_pull_request",
    "arguments": {
      "issue_id": "...",
      "url": "..."
    }
  }
}
list_alert_rulesread-onlyThis app's alert rules with their triggers, conditions, channels and throttles. defaults_active means no rule …

This app's alert rules with their triggers, conditions, channels and throttles. defaults_active means no rule is enabled, so the built-in defaults listed there apply. Use it to see what will and won't alert.

ParameterTypeDescription
limitintegeroptionalRows (default 50)
cursorstringoptionalnext_cursor from the last answer

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_alert_rules",
    "arguments": {}
  }
}
list_campaignsread-onlyCampaigns read live from a connected ad platform: status, daily budget and ad sets. Returns a not_connected …

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.

ParameterTypeDescription
providerstringrequiredWhich ad platform One of: meta, apple_search_ads, snapchat, tiktok, google_ads, reddit, test

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_campaigns",
    "arguments": {
      "provider": "meta"
    }
  }
}
list_creatorsread-onlyCreator records with a funnel per creator for the last 28 days in the app's time zone (non-bot clicks, …

Creator records with a funnel per creator for the last 28 days in the app's time zone (non-bot clicks, installs split exact / weak / modelled, trials, paying users, cohort net revenue and ROAS against the deal cost) and the tracking links tagged to each.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_creators",
    "arguments": {}
  }
}
list_dependenciesread-onlyThe HTTP hosts and database tables the app's services call, by total time spent: calls, calls per minute, …

The HTTP hosts and database tables the app's services call, by total time spent: calls, calls per minute, error rate, p50 to p99, 4xx and 5xx. kind http, db or all (default). Open one with get_endpoint_summary (op http.client or db).

ParameterTypeDescription
kindstringoptionalOne of: http, db, all
limitintegeroptional
rangestringoptionalWindow: 1h, 24h, 7d, 14d, 30d or 90d (default 24h). Ignored when from is given. One of: 1h, 24h, 7d, 14d, 30d, 90d
fromstringoptionalAn ISO time, or how long ago: 30m, 24h, 7d
tostringoptionalAn ISO time, or how long ago (default now)
environmentstringoptionalLike production. Default: production when the app has it, else its busiest non-development one. 'all' for every environment.
releasestringoptionalOnly this release: 2.0.77+185, 2.0.77 (every build) or package@2.0.77+185
servicestringoptionalOnly this service, like house-ai-api or the app's bundle id
sourcestringoptionalbackend (servers), frontend (app and web), or all (default) One of: backend, frontend, all

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_dependencies",
    "arguments": {}
  }
}
list_docsread-onlyThe full documentation index — every page path, grouped by section, with a one-line description. Use it to …

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.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_docs",
    "arguments": {}
  }
}
list_error_alertsread-onlyEvery error alert Fictura fired, newest first: when, which trigger, the issue and its source, the channels, …

Every error alert Fictura fired, newest first: when, which trigger, the issue and its source, the channels, and whether it was delivered. Use it to check an alert went out, or what paged someone.

ParameterTypeDescription
limitintegeroptionalRows (default 25)
cursorstringoptionalnext_cursor from the last answer

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_error_alerts",
    "arguments": {}
  }
}
list_error_issuesread-onlyStart here to see what is broken: grouped issues from the backend and the app together, each with its source, …

Start here to see what is broken: grouped issues from the backend and the app together, each with its source, level, status, event and user counts. Newest activity first, unresolved only. Console lines from the app are hidden unless include_console is true. Pass next_cursor to read on.

ParameterTypeDescription
statusstringoptionalWhich issues (default unresolved) One of: unresolved, resolved, ignored, discarded, all
sourcestringoptionalThe server, the app, or both (default all) One of: backend, frontend, all
levelstringoptionalOne of: fatal, error, warning, info
environmentstringoptionalIssues with an event in this environment
releasestringoptionalText in a release the issue was seen in: 2.0.77+185, or package@2.0.77+185
platformstringoptionalLike python, ios, android
sincestringoptionalLast seen since: an ISO time, or 30m, 24h, 7d
sortstringoptionalDefault last_seen. new = first seen most recently One of: last_seen, events, users, new
limitintegeroptionalRows (default 25)
cursorstringoptionalnext_cursor from the last answer
include_consolebooleanoptionalAlso list console lines from the app (default false)
include_sparkbooleanoptionalAdd a 14-day sparkline per row (default false)
include_legacybooleanoptionalAlso list issues grouped before grouping v2 (default false)

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_error_issues",
    "arguments": {}
  }
}
list_experimentsread-onlyEvery experiment with status and, for running or finished ones, full Bayesian results — exposures, …

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

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_experiments",
    "arguments": {}
  }
}
list_inbound_filtersread-onlyThis app's inbound filters: rules that drop a matching error at ingest, counted but never stored or alerted …

This app's inbound filters: rules that drop a matching error at ingest, counted but never stored or alerted on. exc_type and release match exactly, message is a glob (* = anything, any case), environment is exact and `simulator` also drops simulator events. discarded_7d counts drops per reason.

ParameterTypeDescription
limitintegeroptionalRows (default 50)
cursorstringoptionalnext_cursor from the last answer

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_inbound_filters",
    "arguments": {}
  }
}
list_monitorsread-onlyEvery performance monitor: what it watches (metric, ops, route), its threshold and window, and its state (ok, …

Every performance monitor: what it watches (metric, ops, route), its threshold and window, and its state (ok, firing, no_data) with the last value read. A firing monitor has an open issue: issue_id opens with get_error_issue.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_monitors",
    "arguments": {}
  }
}
list_releasesread-onlyReleases from the app and the backend, newest first: crash-free sessions, users and adoption for the app, …

Releases from the app and the backend, newest first: crash-free sessions, users and adoption for the app, crash-free and error-free requests for the backend. Use it to tell whether a release made things worse. crashed_sessions counts crashes and bad exits; abnormal_sessions is the bad exits (no crash report, an AbnormalExit issue). `release` (version+build) is the name every tool takes.

ParameterTypeDescription
sourcestringoptionalDefault all One of: backend, frontend, all
daysintegeroptionalWindow in days (default 30)
limitintegeroptionalRows (default 25)
cursorstringoptionalnext_cursor from the last answer

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_releases",
    "arguments": {}
  }
}
list_store_productsread-onlyThis app's auto-renewable subscriptions in App Store Connect: product id, billing period and Apple review …

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).

ParameterTypeDescription
subscription_idstringoptionalAlso return price points for this subscription
territorystringoptionalTerritory for price points (default USA)

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_store_products",
    "arguments": {}
  }
}
list_surfacesread-onlyEvery paywall and onboarding flow, what is actually being served at each placement (running experiment > live …

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.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_surfaces",
    "arguments": {}
  }
}
list_templatesread-onlyThe one-click starter templates available for paywalls or onboarding flows, with the template key and what …

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.

ParameterTypeDescription
kindstringrequiredWhich template catalog One of: paywall, onboarding

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_templates",
    "arguments": {
      "kind": "paywall"
    }
  }
}
list_usersread-onlyThe app's users, most recently active first — each with an identity label, event count, last seen, and …

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.

ParameterTypeDescription
limitintegeroptionalMax users (default 50)
churn_statestringoptionalOnly users in this billing state One of: in_trial, converted, cancelled, expired, billing_issue, grace_period, paused, refunded …

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_users",
    "arguments": {}
  }
}
pair_editorcan modifyConnects to the paywall editor a person has open, using the 6-character code shown under “Pair an agent” in …

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.

ParameterTypeDescription
codestringrequiredThe code shown in the editor

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "pair_editor",
    "arguments": {
      "code": "..."
    }
  }
}
pause_experimentcan modifyPause a running test: nobody new enrolls, and users already in it keep their arm. resume_experiment picks it …

Pause a running test: nobody new enrolls, and users already in it keep their arm. resume_experiment picks it up again. Only works when the app allows MCP writes.

ParameterTypeDescription
idstringrequiredExperiment id, from list_experiments

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "pause_experiment",
    "arguments": {
      "id": "..."
    }
  }
}
read_docread-onlyThe complete markdown of one documentation page. Accepts a site-relative path such as …

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.

ParameterTypeDescription
pathstringrequiredPage path, e.g. /implementation/sdk-reference/expo-react-native

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "read_doc",
    "arguments": {
      "path": "..."
    }
  }
}
resume_experimentcan modifyResume a paused test so new users enroll again. Refused when another test now holds its surface and …

Resume a paused test so new users enroll again. Refused when another test now holds its surface and placement. Only works when the app allows MCP writes.

ParameterTypeDescription
idstringrequiredExperiment id, from list_experiments

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "resume_experiment",
    "arguments": {
      "id": "..."
    }
  }
}
save_onboarding_doccan modifydestructiveReplaces a draft flow's document with the one given, as a new version (the dashboard's history shows it as …

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.

ParameterTypeDescription
idstringrequiredThe draft flow's id
docobjectrequiredThe complete edited document
notestringoptionalWhat changed, for the version history

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "save_onboarding_doc",
    "arguments": {
      "id": "...",
      "doc": {}
    }
  }
}
save_paywall_doccan modifydestructiveReplaces a draft paywall's document with the one given, as a new version (History in the dashboard shows it …

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.

ParameterTypeDescription
idstringrequiredThe draft paywall's id
docobjectrequiredThe complete edited document
notestringoptionalWhat changed, for the version history

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "save_paywall_doc",
    "arguments": {
      "id": "...",
      "doc": {}
    }
  }
}
search_docsread-onlyFull-text search across the Fictura docs, grouped by page. Use this before answering any 'how do I…' question …

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.

ParameterTypeDescription
querystringrequiredWhat to search for, e.g. 'purchases adapter'
limitintegeroptionalMax pages to return (default 8)

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search_docs",
    "arguments": {
      "query": "..."
    }
  }
}
search_error_eventsread-onlySingle occurrences across issues, newest first, or counts with group_by. Use it to answer which release or …

Single occurrences across issues, newest first, or counts with group_by. Use it to answer which release or route an error hits, whether a person hit it, or what failed in one trace. Open one with get_error_event.

ParameterTypeDescription
issue_idstringoptionalOnly this issue
querystringoptionalText in the message, or the issue's title or culprit
sourcestringoptionalDefault all One of: backend, frontend, all
levelstringoptionalOne of: fatal, error, warning, info
releasestringoptionalText in the release: 2.0.77+185, or package@2.0.77+185
environmentstringoptional
user_idstringoptionalAn account id, Fictura user id or device id
trace_idstringoptional
sincestringoptionalAn ISO time, or 30m, 24h, 7d. Default 30 days, or all kept events with issue_id or trace_id
group_bystringoptionalCounts per release, route, level, environment or tag:name
include_consolebooleanoptionalAlso count console lines from the app. Always on with issue_id or trace_id
limitintegeroptionalRows (default 25)
cursorstringoptionalnext_cursor from the last answer

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search_error_events",
    "arguments": {}
  }
}
search_error_issuesread-onlyFind an issue by text in its title or culprit, across every issue the app has. Use it when you know the error …

Find an issue by text in its title or culprit, across every issue the app has. Use it when you know the error message, exception type or function. Same filters and rows as list_error_issues.

ParameterTypeDescription
querystringoptionalText to look for in the title or culprit
statusstringoptionalWhich issues (default unresolved) One of: unresolved, resolved, ignored, discarded, all
sourcestringoptionalThe server, the app, or both (default all) One of: backend, frontend, all
levelstringoptionalOne of: fatal, error, warning, info
environmentstringoptionalIssues with an event in this environment
releasestringoptionalText in a release the issue was seen in: 2.0.77+185, or package@2.0.77+185
platformstringoptionalLike python, ios, android
sincestringoptionalLast seen since: an ISO time, or 30m, 24h, 7d
sortstringoptionalDefault last_seen. new = first seen most recently One of: last_seen, events, users, new
limitintegeroptionalRows (default 25)
cursorstringoptionalnext_cursor from the last answer
include_consolebooleanoptionalAlso list console lines from the app (default false)
include_sparkbooleanoptionalAdd a 14-day sparkline per row (default false)
include_legacybooleanoptionalAlso list issues grouped before grouping v2 (default false)

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search_error_issues",
    "arguments": {}
  }
}
search_logsread-onlyApplication log lines from the backend SDK, newest first, or counts with group_by. Use it to see what …

Application log lines from the backend SDK, newest first, or counts with group_by. Use it to see what happened around an error: pass trace_id for one request's lines, or q and level to search. Lines are kept 14 days, and the default range is the last 24 hours.

ParameterTypeDescription
qstringoptionalText in the message, any case
levelstringoptionaltrace, debug, info, warning, error or fatal; commas for several
loggerstringoptional
routestringoptional
releasestringoptional
environmentstringoptional
trace_idstringoptionalOne trace's lines, however old
user_idstringoptional
fromstringoptionalAn ISO time, or 30m, 24h, 7d
tostringoptionalAn ISO time, or how long ago
group_bystringoptionalCounts per value instead of lines One of: logger, level, route, release
message_charsintegeroptionalCharacters of each message (default 500)
limitintegeroptionalLines (default 50)
cursorstringoptionalnext_cursor from the last answer

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search_logs",
    "arguments": {}
  }
}
search_tracesread-onlyWith no filters: every route and screen with its count, error rate, p50, p95 and slowest dependency. With any …

With no filters: every route and screen with its count, error rate, p50, p95 and slowest dependency. With any filter: matching spans from the backend and the app, or count, avg, p50, p95 and errors with group_by. Use it to find what is slow or failing, then open one with get_trace. Spans are kept 30 days.

ParameterTypeDescription
qstringoptionalText in the span name, any case
opstringoptionalLike http.server, http.client, ui.load, app.start, gen_ai, mcp.server
servicestringoptional
routestringoptional
statusstringoptionalok, error, or one HTTP status like 503
sourcestringoptionalDefault all One of: backend, frontend, all
min_duration_msnumberoptional
fromstringoptionalAn ISO time, or 30m, 24h, 7d (default 24h)
tostringoptionalAn ISO time, or how long ago
group_bystringoptionalCounts and timings per value instead of spans. release and environment also give p75, p90, p99 and time spent One of: op, route, service, status, name, release, environment
environmentstringoptionalOnly this environment, like production ('all' for every one)
releasestringoptionalOnly this release: 2.0.77+185, 2.0.77 (every build) or package@2.0.77+185
timeseriesbooleanoptionaltrue: points over time instead of rows (per minute, error rate, p50, p95), with where releases started
sortstringoptionalFor spans (default recent) One of: recent, slowest
rangestringoptionalWindow of the routes overview (default 24h) One of: 1h, 24h, 7d, 30d, 90d
limitintegeroptionalRows (default 50, overview 25)
cursorstringoptionalnext_cursor from the last answer

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search_traces",
    "arguments": {}
  }
}
set_uptime_monitorcan modifySet or replace the URL Fictura pings every minute (three failures in a row mark it down and alert). A new URL …

Set or replace the URL Fictura pings every minute (three failures in a row mark it down and alert). A new URL starts over as unknown. enabled false pauses it. Only works when the app allows MCP writes.

ParameterTypeDescription
urlstringrequiredhttp(s) URL, like https://api.example.com/health
enabledbooleanoptionalDefault true

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "set_uptime_monitor",
    "arguments": {
      "url": "..."
    }
  }
}
start_appsflyer_importcan modifyexternal accessImport everything AppsFlyer holds for this app: installs and the channel, campaign, adset and ad behind each …

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.

ParameterTypeDescription
modestringoptionalDefault auto One of: auto, full
resumebooleanoptionalContinue the last failed or cancelled run

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "start_appsflyer_import",
    "arguments": {}
  }
}
start_experimentcan modifyStart a draft: from now on its arms are served to the users who pass its targeting. Refused when another test …

Start a draft: from now on its arms are served to the users who pass its targeting. Refused when another test is running or paused on the same surface and placement. Only works when the app allows MCP writes.

ParameterTypeDescription
idstringrequiredExperiment id, from list_experiments

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "start_experiment",
    "arguments": {
      "id": "..."
    }
  }
}
start_fix_runcan modifyexternal accessStart a hosted fix run: Fictura's AI finds the root cause and, if allowed, opens a draft PR. It spends the …

Start a hosted fix run: Fictura's AI finds the root cause and, if allowed, opens a draft PR. It spends the app's own Anthropic money, capped per run and per day. Poll get_fix_run. Needs MCP writes and AI fixes on.

ParameterTypeDescription
issue_idstringrequired
stop_atstringoptionalOne of: root_cause, plan, pr

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "start_fix_run",
    "arguments": {
      "issue_id": "..."
    }
  }
}
stop_experimentcan modifydestructiveStop a running or paused test for good without rolling anything out: everyone gets the live config again. It …

Stop a running or paused test for good without rolling anything out: everyone gets the live config again. It can't be restarted. Rolling out a winner is done by a person in the dashboard. Only works when the app allows MCP writes.

ParameterTypeDescription
idstringrequiredExperiment id, from list_experiments

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "stop_experiment",
    "arguments": {
      "id": "..."
    }
  }
}
unpair_editorcan modifyStops this pairing. The editor shows that the agent left.

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

ParameterTypeDescription
pairing_idstringrequiredFrom pair_editor

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "unpair_editor",
    "arguments": {
      "pairing_id": "..."
    }
  }
}
update_app_identitycan modifydestructiveSaves what the app IS to Apple, Google and the web: the iOS bundle ID and Apple Team ID (which build the …

Saves what the app IS to Apple, Google and the web: the iOS bundle ID and Apple Team ID (which build the Universal Links file), the Android package and signing fingerprints (which build the App Links file), both store addresses and the website. Send only the fields you know. Every value is checked before saving, because a bad one makes links fail with no error anywhere. A value already saved is not overwritten unless replace_existing is true: changing a bundle ID on a live app breaks its links, so ask the person first. Needs read and edit access.

ParameterTypeDescription
ios_bundle_idstringoptionalLike com.yourcompany.yourapp
ios_team_idstringoptionalApple Team ID, 10 letters and digits
android_packagestringoptionalLike com.yourcompany.yourapp
android_sha256string[]optionalSHA-256 signing fingerprints, 32 hex pairs split by colons
ios_store_urlstringoptionalhttps://apps.apple.com/… address
android_store_urlstringoptionalhttps://play.google.com/… address
web_urlstringoptionalThe app's website
replace_existingbooleanoptionalOverwrite values already saved. Only after the person has agreed.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "update_app_identity",
    "arguments": {}
  }
}
update_error_issuecan modifyResolve, ignore or reopen an issue, assign it, set its priority, or add a note. Only works when the app …

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).

ParameterTypeDescription
issue_idstringrequired
statusstringoptionalOne of: resolved, ignored, ongoing
resolved_in_releasestringoptional
assigneestring | nulloptional
prioritystring | nulloptional
notestringoptional

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "update_error_issue",
    "arguments": {
      "issue_id": "..."
    }
  }
}
update_error_issuescan modifyThe same change on up to 100 issues: resolve, ignore or reopen them, assign them, set their priority, or add …

The same change on up to 100 issues: resolve, ignore or reopen them, assign them, set their priority, or add a note to each. Answers per issue, with counts. Only works when the app allows MCP writes (Issues settings → Let MCP keys change issues).

ParameterTypeDescription
issue_idsstring[]requiredIssue ids, from list_error_issues
statusstringoptionalOne of: resolved, ignored, ongoing
resolved_in_releasestringoptional
assigneestring | nulloptional
prioritystring | nulloptional
notestringoptional

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "update_error_issues",
    "arguments": {
      "issue_ids": []
    }
  }
}
update_tracing_settingscan modifySet the share of traces the SDKs keep, and the hosts the app's SDK sends trace headers to (replacing the …

Set the share of traces the SDKs keep, and the hosts the app's SDK sends trace headers to (replacing the list). A field you leave out keeps its value. SDKs read it from their config within a minute. Only works when the app allows MCP writes.

ParameterTypeDescription
sample_ratenumberoptional0 to 1; 1 keeps every trace
propagate_tostring[]optionalHosts or origins: api.example.com, *.example.com, https://api.example.com:8443. [] clears it

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "update_tracing_settings",
    "arguments": {}
  }
}
validate_onboarding_docread-onlyRuns a document through the same parser, step-key check and renderer a save uses and reports what is wrong, …

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

ParameterTypeDescription
docobjectrequiredAn onboarding document (version: 1)

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "validate_onboarding_doc",
    "arguments": {
      "doc": {}
    }
  }
}
validate_paywall_docread-onlyRuns a document through the same parser and renderer a save uses and reports what is wrong, if anything. …

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

ParameterTypeDescription
docobjectrequiredA paywall document (version: 1)

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "validate_paywall_doc",
    "arguments": {
      "doc": {}
    }
  }
}

Prompts 1

Badge

Maintain this server? Put its live status in your README:

MCP status badge

[![MCP status](https://mcp.aianytime.net/badge/fictura.svg)](https://mcp.aianytime.net/s/fictura/)

Edit this entry · Report a problem

More in Marketing, content & social

Checks record what a server answered, not whether it is safe. A listing is not a security audit; read a server's source and permissions before you connect it. Add a server · JSON · llms.txt · llms-full.txt

Browse: Agents, IDEs & developer tools · Search & discovery · Knowledge, memory & context · Media & generation · Security · Finance & markets · Marketing, content & social · Cloud, ops & data · Commerce, travel & logistics · Work & productivity · No account needed · Local servers