@fload-ai/mcp 0.2.2 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -23
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# @fload-ai/mcp
|
|
2
2
|
|
|
3
|
-
MCP server for [Fload](https://fload.com) — connects any MCP-compatible AI client (Claude, ChatGPT, Cursor, VS Code, Cline) to your mobile app's App Store Connect and Google Play Console data, App Store and Google Play reviews, ad campaigns,
|
|
3
|
+
MCP server for [Fload](https://fload.com) — connects any MCP-compatible AI client (Claude, ChatGPT, Cursor, VS Code, Cline) to your mobile app's App Store Connect and Google Play Console data, App Store and Google Play reviews, ad campaigns, and ASO data.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Tools for apps, reviews, analytics, agents, ads, ASO, dashboard, pending actions and chat. OAuth 2.1 for remote connections, API key for scripts and CI.
|
|
6
6
|
|
|
7
7
|
## Two ways to connect
|
|
8
8
|
|
|
@@ -66,41 +66,39 @@ For scripts, CI, headless environments, or anyone who wants a long-lived machine
|
|
|
66
66
|
- "Draft replies to my last 5 one-star reviews in my brand voice, then approve the good ones."
|
|
67
67
|
- "What's my ROAS across all ad platforms this week?"
|
|
68
68
|
- "Audit my ASO for my top-grossing app and suggest title changes."
|
|
69
|
-
- "List anomalies across my portfolio this week — acknowledge the ones on my dummy app."
|
|
70
69
|
|
|
71
70
|
## Tools
|
|
72
71
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
| Domain
|
|
76
|
-
|
|
77
|
-
| Apps
|
|
78
|
-
| Reviews
|
|
79
|
-
| Analytics | `discover_metrics`, `get_metrics`, `discover_dimensions` (30+ metrics, dimensional breakdowns)
|
|
80
|
-
| Agents
|
|
81
|
-
|
|
|
82
|
-
|
|
|
83
|
-
|
|
|
84
|
-
|
|
|
85
|
-
|
|
|
86
|
-
| Chat | `list_conversations`, `get_conversation_messages`, `send_chat_message` |
|
|
72
|
+
Tools grouped by domain. Full list with annotations + scope requirements at [fload.com/docs/mcp](https://fload.com/docs/mcp).
|
|
73
|
+
|
|
74
|
+
| Domain | Tools |
|
|
75
|
+
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
76
|
+
| Apps | `list_apps`, `get_app_details` |
|
|
77
|
+
| Reviews | `get_reviews`, `generate_review_reply`, `send_review_reply`, `translate_review` |
|
|
78
|
+
| Analytics | `discover_metrics`, `get_metrics`, `discover_dimensions` (30+ metrics, dimensional breakdowns) |
|
|
79
|
+
| Agents | `list_agents`, `get_agent_details`, `get_agent_run_history`, `trigger_agent_run`, `pause_agent`, `resume_agent`, `get_agent_activity` |
|
|
80
|
+
| Ads | `get_ads_performance` (Apple Search Ads, Google Ads, Meta Ads, TikTok Ads) |
|
|
81
|
+
| ASO | `get_aso_summary`, `get_aso_recommendations`, `get_aso_keywords`, `get_aso_evidence`, `get_aso_experiments`, `get_aso_locale_snapshots`, `trigger_aso_analysis` |
|
|
82
|
+
| Dashboard | `get_dashboard_overview` |
|
|
83
|
+
| Actions | `list_pending_actions`, `approve_action`, `reject_action` |
|
|
84
|
+
| Chat | `list_conversations`, `get_conversation_messages`, `send_chat_message` |
|
|
87
85
|
|
|
88
86
|
Every tool carries an MCP `readOnlyHint` or `destructiveHint` annotation so clients can surface the scope of each action to users before calling.
|
|
89
87
|
|
|
90
88
|
## OAuth scopes (remote only)
|
|
91
89
|
|
|
92
|
-
|
|
90
|
+
15 scopes. Agents request the minimum they need; users approve per-scope on the consent screen and can revoke from [platform.fload.com/settings/connected-apps](https://platform.fload.com/settings/connected-apps).
|
|
93
91
|
|
|
94
92
|
- **OIDC identity:** `openid`, `email`, `profile`, `offline_access`
|
|
95
|
-
- **Reads:** `read:apps`, `read:reviews`, `read:analytics`, `read:
|
|
93
|
+
- **Reads:** `read:apps`, `read:reviews`, `read:analytics`, `read:ads`, `read:aso`, `read:agents`
|
|
96
94
|
- **Writes:** `write:reviews`, `write:ads`, `write:aso`, `write:agents`, `write:chat`
|
|
97
95
|
|
|
98
96
|
## Configuration (stdio mode)
|
|
99
97
|
|
|
100
|
-
| Variable
|
|
101
|
-
|
|
102
|
-
| `FLOAD_API_KEY` | Yes (stdio) | —
|
|
103
|
-
| `FLOAD_API_URL` | No
|
|
98
|
+
| Variable | Required | Default | Description |
|
|
99
|
+
| --------------- | ----------- | ----------------------- | ---------------------------------- |
|
|
100
|
+
| `FLOAD_API_KEY` | Yes (stdio) | — | API key, format `fload_sk_...` |
|
|
101
|
+
| `FLOAD_API_URL` | No | `https://api.fload.com` | API URL (override for self-hosted) |
|
|
104
102
|
|
|
105
103
|
## Issues & feedback
|
|
106
104
|
|