appstore-api-mcp 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/) and the project uses
 [Semantic Versioning](https://semver.org/).
 
+## [1.0.1] - 2026-06-02
+
+### Added
+- Setup instructions for **OpenAI Codex CLI** (TOML config) and **Gemini CLI**.
+
+### Changed
+- Description and docs reworded to make the client-agnostic support explicit (no longer Claude-centric).
+
 ## [1.0.0] - 2026-06-02
 
 ### Added

package/README.md

@@ -10,7 +10,7 @@ versions — plus a raw-request tool that reaches the **entire**
 > *"show the English description for MyApp"*, or
 > *"upload these screenshots to the 6.7-inch set"* — the agent calls the right tools.
 
-- 🤖 **Works with any MCP client** — Claude Code/Desktop, Cursor, Cline, Windsurf, VS Code (agent mode), Zed, Continue, and custom agents on the MCP SDKs. Standard stdio server, no client-specific code. → [docs/CLIENTS.md](docs/CLIENTS.md)
+- 🤖 **Works with any MCP client** — Claude Code/Desktop, OpenAI Codex CLI, Cursor, Cline, Windsurf, VS Code (agent mode), Zed, Continue, Gemini CLI, and custom agents on the MCP SDKs. Standard stdio server, no client-specific code. → [docs/CLIENTS.md](docs/CLIENTS.md)
 - ✅ **One-line install** via `npx` — no clone, no build
 - ✅ **Credentials stay on your machine** — calls go straight to Apple, nothing is proxied
 - ✅ **Slim, well-described tool set** + a `raw_request` escape hatch for the whole API
@@ -87,12 +87,14 @@ the same; only each client's config format/location differs.
 | --- | --- |
 | **Claude Code** | `claude mcp add …` (see above) |
 | **Claude Desktop** | `claude_desktop_config.json` → `mcpServers` |
+| **OpenAI Codex CLI** | `~/.codex/config.toml` → `[mcp_servers.appstore-api]` |
 | **Cursor** | `.cursor/mcp.json` → `mcpServers` |
 | **Cline** (VS Code) | `cline_mcp_settings.json` → `mcpServers` |
 | **Windsurf** | `~/.codeium/windsurf/mcp_config.json` → `mcpServers` |
 | **VS Code** (agent mode) | `.vscode/mcp.json` → `servers` (note: not `mcpServers`) |
 | **Zed** | `settings.json` → `context_servers` |
 | **Continue** | `~/.continue/config.yaml` → `mcpServers` |
+| **Gemini CLI** | `~/.gemini/settings.json` → `mcpServers` |
 | **Custom agent** (MCP SDK / Agents SDK / LangChain) | spawn the stdio command with the env vars |
 
 Copy-paste config snippets for each are in **[docs/CLIENTS.md](docs/CLIENTS.md)**.

package/docs/CLIENTS.md

@@ -56,6 +56,19 @@ claude mcp add appstore-api \
 }
 ```
 
+## OpenAI Codex CLI
+
+Codex uses **TOML**, not JSON. Add to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.appstore-api]
+command = "npx"
+args = ["-y", "appstore-api-mcp"]
+env = { ASC_KEY_ID = "YOUR_KEY_ID", ASC_ISSUER_ID = "YOUR_ISSUER_ID", ASC_PRIVATE_KEY_PATH = "/absolute/path/to/AuthKey.p8" }
+```
+
+(You can also manage this with `codex mcp add` if your Codex version supports it.)
+
 ## Cursor
 
 Project-level `.cursor/mcp.json` (or global `~/.cursor/mcp.json`) — same shape:
@@ -143,6 +156,26 @@ mcpServers:
       ASC_PRIVATE_KEY_PATH: /absolute/path/to/AuthKey.p8
 ```
 
+## Gemini CLI
+
+In `~/.gemini/settings.json` — same `mcpServers` shape as Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "appstore-api": {
+      "command": "npx",
+      "args": ["-y", "appstore-api-mcp"],
+      "env": {
+        "ASC_KEY_ID": "YOUR_KEY_ID",
+        "ASC_ISSUER_ID": "YOUR_ISSUER_ID",
+        "ASC_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey.p8"
+      }
+    }
+  }
+}
+```
+
 ## Any other MCP client / custom agent
 
 Point your client at a stdio server with:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "appstore-api-mcp",
-  "version": "1.0.0",
-  "description": "MCP server for Apple App Store Connect — manage apps, keywords, descriptions, titles, screenshots, versions and the full API from any MCP client (Claude, Cursor, Cline, Windsurf, VS Code, Zed, Continue, and custom agents). Includes a fleet-wide ASO audit and dry-run previews.",
+  "version": "1.0.1",
+  "description": "MCP server for Apple App Store Connect — manage apps, keywords, descriptions, titles, screenshots, versions and the full API from any MCP client (Claude, Codex, Cursor, Cline, Windsurf, VS Code, Zed, Continue, Gemini CLI, and custom agents). Includes a fleet-wide ASO audit and dry-run previews.",
   "type": "module",
   "bin": {
     "appstore-api-mcp": "src/index.js"
@@ -29,6 +29,8 @@
     "ios",
     "apple",
     "claude",
+    "codex",
+    "cursor",
     "keywords",
     "screenshots",
     "metadata"