How to Use the Appfigures MCP in Mastra AI

Q: Can Mastra AI trigger workflows based on Appfigures sales drops?

Yes, you can schedule a workflow that calls getsalesreport daily. If downloads fall below your target, the agent automatically branches to analyze your current keyword rankings.

Q: Does the Appfigures MCP Server support multiple store accounts in a single Mastra AI workflow?

Yes. The workflow can query getexternalaccounts to discover all linked App Store and Google Play profiles, then loop through each to collect consolidated performance data.

Build automated Mastra AI workflows to track Appfigures ratings and trigger alerts when rankings drop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Appfigures MCP to Mastra AI

Create your Vinkius account to connect Appfigures to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Appfigures with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Workflow-Driven Revenue Reports

Mastra AI agents excel at running complex multi-step operations when metrics fluctuate. Use `get_revenue_report` to check daily earnings, then let the workflow engine decide if it needs to trigger alerts. If the Appfigures API rate-limits your request, the framework automatically retries with exponential backoff. You get reliable financial reporting without writing manual error-handling code.

Automated Rank Tracking with Mastra AI

Set up a loop that monitors store visibility without manual intervention. This MCP Server pulls daily positions using `get_ranks`, while `list_featured` checks if an editorial feature caused the spike. When rankings slip below a threshold, the agent branches to run `search_products` on competitors. This gives you immediate competitive intelligence the moment your organic search traffic shifts.

Conditional Review Escalation

Filter incoming feedback automatically. Your agent uses `list_reviews` to pull recent comments and evaluates the sentiment. If a review drops below three stars, Mastra AI triggers a branch to notify your support team. You preserve your app store reputation by addressing bugs before they trend.

Setup guide

Set up Appfigures MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Appfigures tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "appfigures-mcp-client",
  servers: {
    "appfigures-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Appfigures Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Appfigures tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Appfigures transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Appfigures. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Appfigures now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Appfigures MCP in Mastra AI

Instantiate the MCPClient with your Vinkius server URL. Spread the tools from listTools directly into your agent's tool configuration array.

Yes, you can schedule a workflow that calls `get_sales_report` daily. If downloads fall below your target, the agent automatically branches to analyze your current keyword rankings.

You can enable requireToolApproval for sensitive actions. For example, before the agent pulls a broad `get_revenue_report`, it will pause and wait for your confirmation in the console.

Yes. The workflow can query `get_external_accounts` to discover all linked App Store and Google Play profiles, then loop through each to collect consolidated performance data.

All communication between Mastra AI and the MCP server goes through encrypted SSE or HTTP channels. Vinkius processes your app store sales, subscription metrics, and developer tokens in isolated, zero-trust sandboxes that wipe all memory immediately after execution.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript