Skip to content
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -522,6 +522,11 @@
"name": "square",
"source": "third_party/square",
"description": "Work with payments, orders, catalog, customers, and invoices."
},
{
"name": "grok-video",
"source": "third_party/grok-video",
"description": "Generate Grok Video clips and retrieve the finished video."
}
]
}
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| `quickbooks-online` | [QuickBooks Online](third_party/quickbooks-online/) | Cursor | Integrations | Read invoices, bills, expenses, customers, accounts, and financial reports. |
| `workday` | [Workday](third_party/workday/) | Cursor | Integrations | Look up workers, organizations, time off, payroll, and recruiting data in Workday. |
| `square` | [Square](third_party/square/) | Cursor | Integrations | Work with payments, orders, catalog, customers, and invoices. |
| `grok-video` | [Grok Video](third_party/grok-video/) | Ace Data Cloud Dev | Integrations | Generate Grok Video clips and retrieve the finished video. |
Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `plugins@cursor.com` in the manifest).

## Repository structure
Expand Down
31 changes: 31 additions & 0 deletions third_party/grok-video/.cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
{
"name": "grok-video",
"displayName": "Grok Video",
"version": "1.0.0",
"minClientVersions": {
"cursor": "3.13.0"
},
"description": "Generate Grok Video clips and retrieve the finished video.",
"author": {
"name": "Ace Data Cloud Dev",
"email": "dev@acedata.cloud"
},
"homepage": "https://platform.acedata.cloud/models",
"repository": "https://github.com/AceDataCloud/GrokVideoCursor",
"license": "MIT",
"logo": "assets/logo.png",
"keywords": [
"grok-video",
"grok video",
"video",
"acedatacloud",
"mcp"
],
"category": "integrations",
"tags": [
"grok-video",
"video",
"mcp"
],
"mcpServers": "./mcp.json"
}
Comment thread
cursor[bot] marked this conversation as resolved.
5 changes: 5 additions & 0 deletions third_party/grok-video/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Changelog

## 1.0.0

- Initial Grok Video Cursor plugin using the existing Ace Data Cloud hosted MCP.
21 changes: 21 additions & 0 deletions third_party/grok-video/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2026 Ace Data Cloud

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
58 changes: 58 additions & 0 deletions third_party/grok-video/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# Grok Video for Cursor

Generate Grok Video clips and retrieve the finished video. This standalone plugin reuses the [Ace Data Cloud grok MCP](https://github.com/AceDataCloud/MCPs/tree/main/grok) and includes a focused Agent skill. Available tools and limits come from the live MCP schema.

[简体中文教程](readme/README_zh_Hans.md) · [Copyable first-run prompt](examples/first-run.md) · [Current pricing](https://platform.acedata.cloud/models)

## 1. Search and install

In Cursor 3.13 or later, open **Cursor Settings → Plugins**, search for **Grok Video**, confirm **Ace Data Cloud Dev** and the service logo, then click **Install**. You can also use `/add-plugin grok-video` in chat. If the official listing is not live, review this source under `~/.cursor/plugins/local/grok-video/`; local installation does not prove Marketplace publication.

## 2. Get a service API key

1. Sign in at [Ace Data Cloud Applications](https://platform.acedata.cloud/console/applications).
2. Open **General application** or a service-specific application. Copy an existing API key, or use **Manage Keys → Create** for a separate Cursor key.
3. Confirm Grok Video access, [current price](https://platform.acedata.cloud/models), and balance. If **Allowed APIs** restrictions are enabled, include /grok/videos, /grok/tasks.

Use a service API key, not a platform management token. Do not put it in chat or source files.

## 3. Configure the plugin

Under **Dashboard → Plugins → Configure**, select **Grok Video** and set `ACEDATACLOUD_API_TOKEN` to the key string. Paste only the key; the plugin adds `Bearer `. Reconnect the MCP server if tools are missing. The hosted endpoint needs no local Python installation.

```json
{
"mcpServers": {
"grok": {
"type": "http",
"url": "https://grok.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer ${ACEDATACLOUD_API_TOKEN}"
}
}
}
}
```

The shared grok MCP also offers other tools. Restrict the key to Grok Video APIs if this installation should be limited to Grok Video.

## 4. Run the first example

Open Cursor Agent and paste the [first-run prompt](examples/first-run.md). It asks for `grok_text_to_video`, model `grok-imagine-video-1.5-fast:reverse` and duration 6 seconds, resolution 480p. The sample prompt is `A teal cube slowly rotates on a cream tabletop, studio lighting, no text.`. Verify live model access and price before running.

Submit with `grok_text_to_video` once. Save the returned `task_id` and use `grok_get_task` with that same ID until terminal. Pending is not a completed video; open the returned result URL on success. Never regenerate merely to poll.

Open the returned video and inspect it. In **Ace Data Cloud → Usage/Billing**, match this call to its deducted Credits record. The plugin is free; API calls follow current service pricing.

## Troubleshooting

| Symptom | Action |
| --- | --- |
| Plugin or tools are missing | Check the Grok Video listing, configure the key, and reconnect MCP. |
| 401 or 403 | Check key validity, service access, balance, and Allowed APIs; do not include `Bearer ` in the configured value. |
| Invalid model or argument | Use the live tool schema and a model this account can access. |
| Pending task | Query the original task ID; do not regenerate to poll. |
| 429, timeout, or 5xx | Inspect the original task and usage history before another paid submission. |
| Result URL will not open | Confirm a terminal success and use the URL returned by that call. |

[Source](https://github.com/AceDataCloud/GrokVideoCursor) · [Report a problem](https://github.com/AceDataCloud/GrokVideoCursor/issues) · dev@acedata.cloud. The logo reuses an existing Ace Data Cloud integration asset. This tool plugin does not register a Cursor chat-model provider.
Binary file added third_party/grok-video/assets/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
5 changes: 5 additions & 0 deletions third_party/grok-video/examples/first-run.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# First Grok Video run

Copy this into Cursor Agent after installing and configuring the plugin. No key is included.

> Use the grok MCP tool grok_text_to_video for one video request. I checked the current Ace Data Cloud price and balance. Use model grok-imagine-video-1.5-fast:reverse if this account offers it. Set duration 6 seconds, resolution 480p. Set prompt to A teal cube slowly rotates on a cream tabletop, studio lighting, no text.. Submit at most once, keep the task ID, query it using grok_get_task until terminal, and open the completed result. If pending, report the ID so I can resume without a second generation.
11 changes: 11 additions & 0 deletions third_party/grok-video/mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"mcpServers": {
"grok": {
"type": "http",
"url": "https://grok.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer ${ACEDATACLOUD_API_TOKEN}"
}
}
}
}
44 changes: 44 additions & 0 deletions third_party/grok-video/readme/README_zh_Hans.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Cursor Grok Video 插件

Generate Grok Video clips and retrieve the finished video. 插件复用 [Ace Data Cloud grok MCP](https://github.com/AceDataCloud/MCPs/tree/main/grok),并提供专用 Agent skill。实际工具参数和限制以在线 MCP schema 为准。

[English guide](../README.md) · [可复制的首跑提示词](../examples/first-run.md) · [当前价格](https://platform.acedata.cloud/models)

## 1. 搜索安装

在 Cursor 3.13 或更新版本打开 **Cursor Settings → Plugins**,搜索 **Grok Video**,确认作者 **Ace Data Cloud Dev** 和服务图标后点击 **Install**。也可在聊天中输入 `/add-plugin grok-video`。若官方条目尚未出现,可在 `~/.cursor/plugins/local/grok-video/` 本地审查;本地安装不代表 Marketplace 已上架。

## 2. 获取服务 API Key

1. 登录 [Ace Data Cloud 应用管理](https://platform.acedata.cloud/console/applications)。
2. 打开 **General application** 或服务专用应用,复制已有 Key;也可通过 **Manage Keys → Create** 新建 Cursor 专用 Key。
3. 确认 Grok Video 权限、[当前价格](https://platform.acedata.cloud/models)和余额。若启用了 **Allowed APIs**,允许 /grok/videos, /grok/tasks。

使用服务 API Key,不要用平台管理 token,也不要放在聊天或仓库文件中。

## 3. 配置插件

在 **Dashboard → Plugins → Configure** 选择 **Grok Video**,将 Key 原文填入 `ACEDATACLOUD_API_TOKEN`。插件会自行添加 `Bearer `,连接 `https://grok.mcp.acedata.cloud/mcp`;无需安装本地 Python 服务。工具未出现时重新连接 MCP。

The shared grok MCP also offers other tools. Restrict the key to Grok Video APIs if this installation should be limited to Grok Video.

## 4. 首次调用

在 Cursor Agent 中复制[首跑提示词](../examples/first-run.md)。它使用 `grok_text_to_video`,模型 `grok-imagine-video-1.5-fast:reverse`,参数为 duration 6 seconds, resolution 480p,prompt 为 `A teal cube slowly rotates on a cream tabletop, studio lighting, no text.`。执行前核对当前模型权限和价格;字段变化时以在线工具 schema 为准。

只用 `grok_text_to_video` 提交一次,保存返回的 `task_id`,随后用同一 ID 调用 `grok_get_task` 直到终态。pending 不代表已完成;成功后打开结果地址。不要为轮询重新生成。

打开返回的video结果并检查。在 **Ace Data Cloud → Usage/Billing** 核对本次调用对应的 Credits 扣费;插件免费,API 按当前服务价格计费。

## 排障

| 现象 | 处理 |
| --- | --- |
| 找不到插件或工具 | 核对 Grok Video 条目、配置 Key 并重连 MCP。 |
| 401 或 403 | 检查 Key、服务权限、余额和 Allowed APIs;配置值不要带 `Bearer `。 |
| 模型或参数错误 | 以在线 MCP schema 和账户可用模型为准。 |
| 任务 pending | 沿原 task ID 查询,不要为轮询重新生成。 |
| 429、超时或 5xx | 先检查原任务和用量记录,再决定是否再次付费提交。 |
| 结果无法打开 | 确认终态成功,打开该次调用返回的地址。 |

[源码](https://github.com/AceDataCloud/GrokVideoCursor) · [问题反馈](https://github.com/AceDataCloud/GrokVideoCursor/issues) · dev@acedata.cloud。图标复用 Ace Data Cloud 现有集成资源。本插件提供工具,不注册 Cursor 聊天模型 Provider。
14 changes: 14 additions & 0 deletions third_party/grok-video/skills/grok-video/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
name: grok-video
description: Use Grok Video through the Ace Data Cloud MCP server in Cursor. Use for Grok Video video work or an existing task query.
---

# Grok Video in Cursor

This skill adapts the [existing Ace Data Cloud skill](https://github.com/AceDataCloud/Skills/tree/main/skills/grok-video). The live MCP schema is the source of truth for arguments and models.

1. Check [current price, balance, and service access](https://platform.acedata.cloud/models) before a paid call.
2. Submit with `grok_text_to_video` once. Save the returned `task_id` and use `grok_get_task` with that same ID until terminal. Pending is not a completed video; open the returned result URL on success. Never regenerate merely to poll.
3. Return the result, task ID if present, and any service error. Keep the API token out of chat and files.

Configure `ACEDATACLOUD_API_TOKEN` under **Dashboard → Plugins → Configure**. See the [first-run guide](../../README.md).