@agentmedia/mcp-server 0.1.0 → 0.1.2

package/.memory/cursor.json

@@ -0,0 +1,3 @@
+{
+  "0bd6ae0e-31bc-4fd0-a11b-5a413dfb6071": 6747
+}

package/.memory/memories.json

@@ -0,0 +1 @@
+[]

package/.memory/project.json

@@ -0,0 +1,5 @@
+{
+  "name": "mcp-server",
+  "description": "",
+  "extractionCount": 3
+}

package/CLAUDE.md

@@ -0,0 +1,7 @@
+<!-- MEMORY:START -->
+# mcp-server
+
+_Last updated: 2026-04-13 | 0 active memories, 0 total_
+
+_For deeper context, use memory_search, memory_related, or memory_ask tools._
+<!-- MEMORY:END -->

package/README.md

@@ -1,28 +1,31 @@
-# @agent-media/mcp-server
+# @agentmedia/mcp-server
 
-MCP server for agent-media — generate UGC videos from Claude Code, Cursor, Windsurf, or any MCP-compatible client.
+MCP server for [agent-media](https://agent-media.ai) — generate AI UGC videos from Claude Code, Cursor, Windsurf, or any MCP-compatible client.
 
-## Setup
+UGC for developers. Script in, video URL out — directly from your IDE.
 
-```bash
-npm install -g @agent-media/mcp-server
-```
+[![npm version](https://img.shields.io/npm/v/@agentmedia/mcp-server)](https://www.npmjs.com/package/@agentmedia/mcp-server)
+[![license](https://img.shields.io/npm/l/@agentmedia/mcp-server)](https://github.com/yuvalsuede/agent-media/blob/main/LICENSE)
 
-Or run directly:
+## What It Does
 
-```bash
-npx @agent-media/mcp-server
-```
+Three tools that let AI agents generate UGC videos:
+
+| Tool | Description |
+|---|---|
+| `create_video` | Generate a UGC video from a script. Polls until complete, returns the video URL. |
+| `list_actors` | Browse available AI actors — slugs, names, demographics. |
+| `get_video_status` | Check a generation job's status, video URL, or error message. |
 
-## Configuration
+## Setup
 
-Set your API key as an environment variable:
+### 1. Get an API Key
 
-```bash
-export AGENT_MEDIA_API_KEY=ma_your_key_here
-```
+Sign up at [agent-media.ai](https://agent-media.ai) and generate an API key in Settings.
+
+### 2. Configure Your IDE
 
-### Claude Code
+#### Claude Code
 
 Add to `~/.claude/settings.json`:
 
@@ -31,7 +34,7 @@ Add to `~/.claude/settings.json`:
   "mcpServers": {
     "agent-media": {
       "command": "npx",
-      "args": ["@agent-media/mcp-server"],
+      "args": ["-y", "@agentmedia/mcp-server"],
       "env": {
         "AGENT_MEDIA_API_KEY": "ma_your_key_here"
       }
@@ -40,29 +43,113 @@ Add to `~/.claude/settings.json`:
 }
 ```
 
-### Cursor
+#### Cursor
 
-Add to Cursor MCP settings with the same configuration.
+Open Settings > MCP Servers > Add Server:
 
-## Tools
+```json
+{
+  "agent-media": {
+    "command": "npx",
+    "args": ["-y", "@agentmedia/mcp-server"],
+    "env": {
+      "AGENT_MEDIA_API_KEY": "ma_your_key_here"
+    }
+  }
+}
+```
 
-### create_video
+#### Windsurf
 
-Generate a UGC video from a script. Submits the job, polls until complete, returns the video URL.
+Open Settings > MCP > Add:
 
-**Parameters:** script, actor_slug, tone, style, music, target_duration, aspect_ratio, allow_broll, broll_images, and more.
+```json
+{
+  "agent-media": {
+    "command": "npx",
+    "args": ["-y", "@agentmedia/mcp-server"],
+    "env": {
+      "AGENT_MEDIA_API_KEY": "ma_your_key_here"
+    }
+  }
+}
+```
+
+#### Global Install (Alternative)
+
+```bash
+npm install -g @agentmedia/mcp-server
+export AGENT_MEDIA_API_KEY=ma_your_key_here
+agent-media-mcp
+```
+
+## Usage Examples
+
+Once configured, ask your AI assistant:
+
+> "Generate a 10-second UGC video with Sofia explaining why our product is great"
+
+> "List available actors and create a product review video with an enthusiastic tone"
+
+> "Check the status of job abc123"
+
+The MCP server handles the API calls, polling, and returns the finished video URL.
+
+## Tool Parameters
+
+### create_video
+
+| Parameter | Type | Description |
+|---|---|---|
+| `script` | string | Video script (50-3000 chars). Required unless `prompt` is set. |
+| `prompt` | string | AI generates the script from this prompt. |
+| `actor_slug` | string | Actor to use (from `list_actors`). |
+| `tone` | string | `energetic`, `calm`, `confident`, `dramatic` |
+| `music` | string | `chill`, `energetic`, `corporate`, `dramatic`, `upbeat` |
+| `style` | string | Subtitle style — 17 options including `hormozi`, `bold`, `neon`, `fire` |
+| `target_duration` | number | `5`, `10`, or `15` seconds |
+| `aspect_ratio` | string | `9:16`, `16:9`, `1:1` |
+| `allow_broll` | boolean | Include AI-generated B-roll footage |
+| `template` | string | `product-review`, `testimonial`, `monologue`, `listicle`, etc. |
+| `composition_mode` | string | `pip` for picture-in-picture |
+| `webhook_url` | string | Async completion callback URL |
 
 ### list_actors
 
-Browse available AI actors. Returns slugs, names, age, gender, nationality.
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `limit` | number | 20 | Max actors to return (max 200) |
+| `offset` | number | 0 | Pagination offset |
 
 ### get_video_status
 
-Check a generation job's status. Returns status, video URL, error message.
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `job_id` | string | Yes | Job ID from `create_video` |
 
 ## Environment Variables
 
 | Variable | Required | Default | Description |
 |---|---|---|---|
-| `AGENT_MEDIA_API_KEY` | Yes | — | Your API key (ma_xxx format) |
-| `AGENT_MEDIA_API_URL` | No | `https://api-v2-production-2f24.up.railway.app` | API base URL |
+| `AGENT_MEDIA_API_KEY` | Yes | — | Your API key (`ma_xxx` format) |
+| `AGENT_MEDIA_API_URL` | No | Production API | Override the API base URL |
+
+## Related Packages
+
+| Package | Description |
+|---|---|
+| [`@agentmedia/sdk`](https://www.npmjs.com/package/@agentmedia/sdk) | TypeScript SDK for direct API integration |
+| [`agent-media-cli`](https://www.npmjs.com/package/agent-media-cli) | CLI tool — generate videos from your terminal |
+| [`@agentmedia/schema`](https://www.npmjs.com/package/@agentmedia/schema) | Shared schema — enums, types, Zod validation |
+| [`agent-media`](https://pypi.org/project/agent-media/) | Python SDK |
+
+## Links
+
+- [Interactive API Docs](https://agent-media.ai/docs/api-reference)
+- [OpenAPI Spec](https://agent-media.ai/openapi.json)
+- [Website](https://agent-media.ai)
+- [GitHub](https://github.com/yuvalsuede/agent-media)
+
+## License
+
+Apache-2.0

package/package.json

@@ -1,8 +1,31 @@
 {
   "name": "@agentmedia/mcp-server",
-  "version": "0.1.0",
+  "version": "0.1.2",
+  "mcpName": "io.github.yuvalsuede/agent-media",
+  "description": "MCP server for agent-media — generate AI UGC videos from Claude Code, Cursor, Windsurf, or any MCP-compatible client.",
   "type": "module",
   "license": "Apache-2.0",
+  "homepage": "https://agent-media.ai/integrations",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yuvalsuede/agent-media.git",
+    "directory": "packages/mcp-server"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude-code",
+    "cursor",
+    "windsurf",
+    "ugc",
+    "video-generation",
+    "ai",
+    "developer-tools",
+    "ai-agent",
+    "talking-head",
+    "text-to-video",
+    "agent-media"
+  ],
   "publishConfig": {
     "access": "public"
   },
@@ -17,7 +40,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
     "zod-to-json-schema": "^3.25.0",
-    "@agentmedia/schema": "0.1.0"
+    "@agentmedia/schema": "0.1.1"
   },
   "devDependencies": {
     "typescript": "^5.7.3"