@instavar/mcp-server 0.4.1 → 0.5.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.
Files changed (3) hide show
  1. package/README.md +24 -4
  2. package/dist/index.js +795 -212
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -4,14 +4,18 @@
4
4
  [![npm](https://img.shields.io/npm/v/%40instavar%2Fmcp-server)](https://www.npmjs.com/package/@instavar/mcp-server)
5
5
  [![Glama score](https://glama.ai/mcp/servers/instavar/mcp-server/badges/score.svg)](https://glama.ai/mcp/servers/instavar/mcp-server)
6
6
 
7
- Make local videos with Instavar's open-source Remotion templates from Claude
8
- Code or Codex. The public template, schema, scaffold, and troubleshooting tools
9
- work without an account or API key.
7
+ One MCP package starts free and grows with the work. Make local videos with
8
+ Instavar's independent, open-source templates for Remotion from Claude Code or
9
+ Codex without an account or API key.
10
+
11
+ Instavar is an independent project and is not affiliated with, sponsored by, or
12
+ endorsed by Remotion AG. Remotion is a trademark of Remotion AG.
10
13
 
11
14
  Add an Instavar API key when you want the hosted workflow:
12
15
  **create → render → approve → publish → metrics**. The authenticated tools are
13
16
  thin HTTP clients to the hosted Instavar API. The package holds **no database
14
- connection** and stores no data of its own.
17
+ connection** and stores no data of its own. You keep the free tools and do not
18
+ install a second server.
15
19
 
16
20
  ## Which model runs?
17
21
 
@@ -101,6 +105,7 @@ Hosted tools, available when `INSTAVAR_API_KEY` is configured:
101
105
  | `list_jobs` | List recent jobs (newest first). |
102
106
  | `get_job_status` | Runs, artifacts, verifications, current video + thumbnail URLs. |
103
107
  | `get_video_state` | Materialized composition state for a job. |
108
+ | `diagnose_render` | Read-only joined render diagnosis with evidence limits and retry recommendations. |
104
109
  | `get_job_metrics` | Platform engagement snapshots for a published job. |
105
110
  | `get_cost_summary` | Infra cost summary (Lambda / RunPod / R2 / WaveSpeed / PoYo). |
106
111
  | `inspect_workflow` | Read the current workflow and its version history. |
@@ -148,3 +153,18 @@ npx @instavar/mcp-server --help
148
153
  ## License
149
154
 
150
155
  MIT
156
+
157
+ ## Creative guidance
158
+
159
+ `get_creative_guide` works without a key. Omit `guideId` to discover the four
160
+ guides, or choose `visual-copy`, `carousel-stories`, `visual-design` or
161
+ `human-review`. The same text is available as Markdown resources at
162
+ `instavar://creative-guides/<guideId>`. The calling assistant applies the guidance
163
+ to the user's brief; this tool does not generate copy, render, save feedback or
164
+ publish media. Carousel recipes are planning guidance, not additional npm renderers.
165
+
166
+ The monorepo sources live in `docs/guides/creative/`. After an edit, run
167
+ `node scripts/build-creative-guides.mjs`; `--check` rejects a stale bundle.
168
+ The generated TypeScript is bundled into the package, so installed clients need
169
+ no checkout files or access to private knowledge stores. Source changes require
170
+ a normal npm release before installed clients receive them.