Tools Reference

The public Forvibe MCP server currently exposes 111 tools, plus 11 autonomous agent tools in organizations the agent is turned on for. Read operations return organization-scoped data; write, delete, credit-spending, and outward store actions depend on your role, scopes, project connections, and plan.

Projects

• list_projects: list projects in the authenticated organization.
• get_project: fetch one project by its public prj_… ID.
• check_project_availability: check whether a project subdomain or mail prefix is available.
• create_project: create a Forvibe project.
• update_project: update editable project fields.

ASO keywords and optimization

• list_tracked_keywords: list a project's tracked keywords.
• track_keyword: start tracking a keyword.
• untrack_keyword: stop tracking a keyword.
• get_keyword_ranking_history: return historical ranking points for a tracked keyword.
• refresh_keyword_metrics: refresh metrics for tracked keywords.
• get_keyword_rankings_overview: summarize current keyword ranks for a project.
• get_aso_optimization: return the current ASO optimization analysis.
• get_aso_suggestions: return actionable ASO suggestions.

Competitors, charts, and app research

• list_competitors: list competitor apps tracked for a project.
• add_competitor: add an App Store or Google Play competitor.
• remove_competitor: stop tracking a competitor.
• get_top_charts: query store top charts by country, category, and chart type.
• list_chart_categories: list valid store chart categories.
• search_apps: search App Store or Google Play apps.
• get_app_metadata: fetch current public store metadata for an app.

ASO history and alerts

• get_visibility_history: return a project's ASO visibility history.
• get_app_analytics: return App Store impressions, page views and downloads by day, territory, source or product page.
• get_app_stats_history: return historical app performance statistics.
• get_competitor_metadata_timeline: show competitor listing changes over time.
• get_aso_alerts: list generated ASO alerts.
• get_aso_sync_status: report the latest ASO synchronization state.
• get_tracking_alert_settings: read keyword and competitor alert preferences.
• set_tracking_alert_settings: update keyword and competitor alert preferences.
• get_competitor_rank_trajectory: return a competitor's rank trajectory.

Screenshots and SS Studio

• list_screenshots: list uploaded or synchronized store screenshots and their image URLs.
• delete_screenshot: permanently delete a Google Play screenshot record from Forvibe. App Store screenshots are read-only.

Screenshot Studio sets

• list_screenshot_sets: list a project's sets with their status, pages, devices, and languages. The product page set, the set the app published last, comes first.
• update_screenshot_set: rename a set or change the devices it is drawn for, free.
• create_screenshot_cli_code: create a one-time code that connects the Forvibe CLI to a set.
• duplicate_screenshot_set: copy a set, its files and its translations into a new set, free.
• get_design_context_schema: return the DesignContext contract a set is started from.
• submit_design_context: validate a DesignContext and start a new set from it.
• update_screenshot_design_context: replace a set's DesignContext before it is created.
• create_screenshot_session_from_screens: start a set from 2 to 8 plain app screenshots.
• plan_screenshot_campaign: plan a set's template, pages, and copy for review, free.
• update_screenshot_plan: adjust the saved plan's template, copy, artwork description, or screens.
• list_screenshot_template_families: list the template families sets are designed with.
• get_screenshot_campaign_schema: return the JSON Schema for editable sets.
• get_screenshot_campaign: fetch a set's DesignContext, plan, pages, editor patches, and CLI connection, or only some pages.
• get_screenshot_campaign_status: poll a set's generation or edit job.
• render_screenshot_pages: render a set's pages as PNG images for one device and language.
• edit_screenshot_campaign: change finished pages with a plain-language instruction.
• update_screenshot_text: set the exact text of lines on finished pages, free.
• edit_screenshot_elements: change element position, size, layer, style, screens, decoration settings, or page backgrounds exactly, or give a translation, or the iPad pages, their own app screens, free.
• list_screenshot_decorations: list the decorations, doodles, anchors, and palette roles a page can use.
• add_screenshot_decoration: add a laurel, star, blob, pattern, underline, burst, or doodle to a page, free.
• highlight_screen_area: lift a part of an app screen out of the phone as a larger card, free.
• add_screenshot_bridge: add or change a shape that runs across two neighboring pages, free.
• reorder_screenshot_pages: put a set's pages in a new order, free.
• translate_screenshot_campaign: translate a finished set into one or two languages per call.
• get_app_store_creatives: read a set's App Store header and search results images, their elements and their App Store Connect state.
• edit_app_store_creative: change an App Store header or search image's elements exactly, or one translation's text.
• push_app_store_creatives: send only the header and search images to App Store Connect: on the editable version as a publish job, or to App Review on their own when only a live version exists.
• list_screenshot_campaign_languages: list a set's original language and translations.
• remove_screenshot_campaign_language: delete one translation of a set.
• push_screenshot_campaign_to_app_store: publish a finished set to the editable App Store version without submitting it for review. It replaces the screenshots there, sends the set's header and search images with them, and makes the set the product page set. It runs in the background and returns a job id.
• get_screenshot_publish_status: how a publish is going, per language, size and image, until it is completed or failed.
• propose_cpp_variants: propose custom product pages for a finished set with App Store pages, each for one feature, audience or search intent, with the keywords it should win from the App Store keyword field and its credits. Free.
• push_cpp_variant: send a custom product page set to App Store Connect as a draft with its screenshots, header and search image, without submitting it for review.

Store listings

• list_listings: list App Store and Google Play listings by locale.
• get_listing: fetch one project, store, and locale listing.
• update_listing: stage listing-field changes in Forvibe.
• publish_listings: explicitly push staged listing changes to App Store Connect or Google Play.
• list_listing_versions: list saved listing-version snapshots.
• get_listing_version: fetch a complete listing-version snapshot.
• localize_listing: AI-localize listing metadata into target locales.

Store reviews

• list_reviews: list App Store or Google Play reviews with filters.
• get_review: fetch one review.
• get_review_stats: summarize rating distribution and unreplied reviews.

App Store review simulation

• simulate_metadata_only: run an AI-assisted rejection-risk simulation against App Store metadata.
• list_review_simulations: list prior simulations for a project.
• get_review_simulation: fetch a complete simulation result.
• get_latest_review_simulation: fetch the most recent completed simulation.

Custom Product Pages (App Store only)

• list_custom_product_pages: list the Custom Product Pages in Forvibe, including pages from the older generator. New pages are made from a Screenshot Studio set with propose_cpp_variants and sent with push_cpp_variant.
• delete_custom_product_page: delete a Custom Product Page from Forvibe.

In-App Events (App Store only)

• list_in_app_events: list In-App Events present in Forvibe.
• get_in_app_event_status: read event generation or push status.
• update_in_app_event: update an event's primary fields.
• localize_in_app_event: AI-localize an event into target locales.
• update_in_app_event_localization: update one event localization.
• delete_in_app_event_localization: delete one event localization.
• push_in_app_event: push a draft event to App Store Connect without submitting it for review.
• delete_in_app_event: delete an event from Forvibe.
• get_in_app_event_suggestions: generate event-content suggestions.

Subscriptions, in-app purchases, and pricing

• list_in_app_products: list subscriptions and one-time in-app purchases.
• get_in_app_product: fetch one product and its metadata.
• get_app_store_product_metadata: fetch App Store product metadata needed for edits.
• sync_in_app_products: synchronize products from connected stores.
• list_pricing_indexes: list pricing-index definitions available to Pricing Studio.
• create_subscription: create a subscription with supported territory prices and metadata.
• create_in_app_purchase: create a one-time in-app purchase.
• update_in_app_product: update editable subscription or in-app purchase fields.
• update_subscription_group: update App Store subscription-group metadata.
• localize_in_app_product: AI-localize product metadata.
• delete_in_app_product: delete an eligible product through the supported store flow.
• list_price_changes: list drafted, scheduled, applied, or rolled-back price changes.
• get_price_change: fetch one price-change plan.
• create_price_change: draft a territory-aware product price change.
• apply_price_change: apply a drafted price change to the connected store.
• cancel_price_change: cancel an eligible price change.
• rollback_price_change: restore prices from an applied change when supported.
• delete_price_change: delete an eligible price-change record.

Forvibe agent

• list_agent_chats: list the user's chats with the Forvibe agent, newest first, or those matching a search.
• get_agent_chat: read a chat's latest messages, the steps the agent took, and the approvals its last reply waits on.
• send_agent_message: send the agent a message in a new or existing chat and wait for its reply. Costs credits like a console message.
• answer_agent_approval: approve or decline the steps the agent's latest reply waits on and let it continue. Approving runs them as the user.

Autonomous agent

Listed only in organizations the autonomous agent is turned on for, on a paid plan. Reading takes agent:read; deciding, undoing, running and pausing take agent:write.

• get_agent_overview: where the autonomous agent stands: on or off, its mode, the briefing, pending approvals, the main numbers and this week's credits.
• list_agent_activity: the agent's log, newest first: checks, reviews, proposals, approvals, changes applied and undone.
• get_agent_review: the agent's latest daily review of one app: its assessment, what it waits on, what Forvibe's rules refused, and its cost.
• list_agent_proposals: the agent's proposals waiting for approval, applied, or all, with their reason.
• get_agent_proposal: one proposal in full, with the changes it makes.
• get_agent_results: the measured outcome of each applied change.
• decide_agent_proposal: approve or reject a proposal. Approving applies it.
• undo_agent_change: undo an applied change while its undo window is open.
• run_agent_now: check an app now and let the agent review it. Costs credits.
• pause_agent_app: stop the agent in one app.
• resume_agent_app: start the agent again in a paused app.

Resource templates

These five read-only templates expose JSON context through forvibe:// URIs:

• forvibe://project/{projectId}: project details.
• forvibe://project/{projectId}/listings: all store listings for a project.
• forvibe://project/{projectId}/reviews/recent: the project's latest reviews.
• forvibe://project/{projectId}/aso: tracked keywords and competitors.
• forvibe://review-simulation/{simulationId}: one review-simulation result.

Prompts

The server exposes four reusable, parameterized prompts:

• aso-audit: run a structured ASO audit.
• prepare-submission-checklist: prepare a store-submission checklist.
• analyze-recent-reviews: summarize recent reviews and propose responses.
• keyword-research-session: guide a competitive keyword-research session.