@runapi.ai/flux-kontext-mcp 0.1.6 → 0.1.8

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 (11) hide show
  1. package/README.md +9 -8
  2. package/data/contract.json +28 -28
  3. package/dist/src/meta.d.ts +1 -1
  4. package/dist/src/meta.js +1 -1
  5. package/examples/claude.mcp.json +1 -4
  6. package/examples/cursor.mcp.json +1 -4
  7. package/examples/roo.mcp.json +1 -4
  8. package/examples/vscode.mcp.json +1 -4
  9. package/examples/windsurf.mcp.json +1 -4
  10. package/package.json +2 -2
  11. package/server.json +4 -4
package/README.md CHANGED
@@ -57,14 +57,14 @@ Codex, Cursor, Windsurf, VS Code, Roo Code, and other MCP hosts can use the same
57
57
  "mcpServers": {
58
58
  "flux-kontext": {
59
59
  "command": "npx",
60
- "args": ["-y", "@runapi.ai/flux-kontext-mcp"],
61
- "env": { "RUNAPI_API_KEY": "${RUNAPI_API_KEY}" }
60
+ "args": ["-y", "@runapi.ai/flux-kontext-mcp"]
62
61
  }
63
62
  }
64
63
  }
65
64
  ```
66
65
 
67
- Create an API key at [runapi.ai](https://runapi.ai) and expose it as `RUNAPI_API_KEY`. `check_pricing` can run without a key; task creation and status polling require one.
66
+ `check_pricing` works before sign-in. For task creation and status polling, ask your assistant to call the `login` tool. It opens a browser login and saves credentials to `~/.config/runapi/config.json`, the same file used by `runapi login`.
67
+ Headless and CI hosts can still set `RUNAPI_API_KEY` before starting the MCP host.
68
68
 
69
69
  Ready-made examples are in [`examples/`](examples/) for Claude, Cursor, Windsurf, VS Code, and Roo Code.
70
70
 
@@ -124,12 +124,13 @@ The assistant calls `check_pricing` and can link to the [Flux Kontext model page
124
124
 
125
125
  ## Configuration
126
126
 
127
- The server reads the API key in this order:
127
+ The server resolves auth in this order:
128
128
 
129
- 1. `RUNAPI_API_KEY` environment variable
130
- 2. `~/.config/runapi/config.json`
129
+ 1. `RUNAPI_API_KEY` environment variable, useful for headless and CI hosts
130
+ 2. `~/.config/runapi/config.json`, created by the MCP `login` tool or `runapi login`
131
+ 3. No key, which still allows `check_pricing`
131
132
 
132
- Example config file:
133
+ The config file is normally managed by login. A pre-provisioned headless config can use:
133
134
 
134
135
  ```json
135
136
  {
@@ -137,7 +138,7 @@ Example config file:
137
138
  }
138
139
  ```
139
140
 
140
- Do not commit real API keys. Get one at [runapi.ai](https://runapi.ai).
141
+ Do not commit real API keys.
141
142
 
142
143
  ---
143
144
 
package/data/contract.json CHANGED
@@ -23,11 +23,8 @@
23
23
  "required": true,
24
24
  "description": "Image description (English only)."
25
25
  },
26
- "watermark": {
27
- "type": "string",
28
- "description": "Watermark identifier."
29
- },
30
26
  "aspect_ratio": {
27
+ "type": "string",
31
28
  "enum": [
32
29
  "21:9",
33
30
  "16:9",
@@ -36,25 +33,16 @@
36
33
  "3:4",
37
34
  "9:16"
38
35
  ],
39
- "type": "string",
40
36
  "description": "Output aspect ratio. Default: 16:9."
41
37
  },
42
- "callback_url": {
43
- "type": "string",
44
- "description": "Webhook URL for async notifications."
45
- },
46
38
  "output_format": {
39
+ "type": "string",
47
40
  "enum": [
48
41
  "jpeg",
49
42
  "png"
50
43
  ],
51
- "type": "string",
52
44
  "description": "Output format. Default: jpeg."
53
45
  },
54
- "safety_tolerance": {
55
- "type": "integer",
56
- "description": "Content safety threshold. 0-6 for generation, 0-2 for editing. Default: 2."
57
- },
58
46
  "source_image_url": {
59
47
  "type": "string",
60
48
  "description": "Source image URL for editing mode."
@@ -66,6 +54,18 @@
66
54
  "enable_prompt_expansion": {
67
55
  "type": "boolean",
68
56
  "description": "Expand the prompt with more detail. Default: false."
57
+ },
58
+ "safety_tolerance": {
59
+ "type": "integer",
60
+ "description": "Content safety threshold. 0-6 for generation, 0-2 for editing. Default: 2."
61
+ },
62
+ "callback_url": {
63
+ "type": "string",
64
+ "description": "Webhook URL for async notifications."
65
+ },
66
+ "watermark": {
67
+ "type": "string",
68
+ "description": "Watermark identifier."
69
69
  }
70
70
  },
71
71
  "flux-kontext-pro": {
@@ -79,11 +79,8 @@
79
79
  "required": true,
80
80
  "description": "Image description (English only)."
81
81
  },
82
- "watermark": {
83
- "type": "string",
84
- "description": "Watermark identifier."
85
- },
86
82
  "aspect_ratio": {
83
+ "type": "string",
87
84
  "enum": [
88
85
  "21:9",
89
86
  "16:9",
@@ -92,25 +89,16 @@
92
89
  "3:4",
93
90
  "9:16"
94
91
  ],
95
- "type": "string",
96
92
  "description": "Output aspect ratio. Default: 16:9."
97
93
  },
98
- "callback_url": {
99
- "type": "string",
100
- "description": "Webhook URL for async notifications."
101
- },
102
94
  "output_format": {
95
+ "type": "string",
103
96
  "enum": [
104
97
  "jpeg",
105
98
  "png"
106
99
  ],
107
- "type": "string",
108
100
  "description": "Output format. Default: jpeg."
109
101
  },
110
- "safety_tolerance": {
111
- "type": "integer",
112
- "description": "Content safety threshold. 0-6 for generation, 0-2 for editing. Default: 2."
113
- },
114
102
  "source_image_url": {
115
103
  "type": "string",
116
104
  "description": "Source image URL for editing mode."
@@ -122,6 +110,18 @@
122
110
  "enable_prompt_expansion": {
123
111
  "type": "boolean",
124
112
  "description": "Expand the prompt with more detail. Default: false."
113
+ },
114
+ "safety_tolerance": {
115
+ "type": "integer",
116
+ "description": "Content safety threshold. 0-6 for generation, 0-2 for editing. Default: 2."
117
+ },
118
+ "callback_url": {
119
+ "type": "string",
120
+ "description": "Webhook URL for async notifications."
121
+ },
122
+ "watermark": {
123
+ "type": "string",
124
+ "description": "Watermark identifier."
125
125
  }
126
126
  }
127
127
  }
package/dist/src/meta.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  export declare const META: {
2
2
  readonly name: "@runapi.ai/flux-kontext-mcp";
3
- readonly version: "0.1.6";
3
+ readonly version: "0.1.7";
4
4
  readonly lineSlug: "flux-kontext";
5
5
  };
package/dist/src/meta.js CHANGED
@@ -1,6 +1,6 @@
1
1
  export const META = {
2
2
  name: "@runapi.ai/flux-kontext-mcp",
3
- version: "0.1.6",
3
+ version: "0.1.7",
4
4
  lineSlug: "flux-kontext"
5
5
  };
6
6
  //# sourceMappingURL=meta.js.map
package/examples/claude.mcp.json CHANGED
@@ -5,10 +5,7 @@
5
5
  "args": [
6
6
  "-y",
7
7
  "@runapi.ai/flux-kontext-mcp"
8
- ],
9
- "env": {
10
- "RUNAPI_API_KEY": "${RUNAPI_API_KEY}"
11
- }
8
+ ]
12
9
  }
13
10
  }
14
11
  }
package/examples/cursor.mcp.json CHANGED
@@ -5,10 +5,7 @@
5
5
  "args": [
6
6
  "-y",
7
7
  "@runapi.ai/flux-kontext-mcp"
8
- ],
9
- "env": {
10
- "RUNAPI_API_KEY": "${RUNAPI_API_KEY}"
11
- }
8
+ ]
12
9
  }
13
10
  }
14
11
  }
package/examples/roo.mcp.json CHANGED
@@ -5,10 +5,7 @@
5
5
  "args": [
6
6
  "-y",
7
7
  "@runapi.ai/flux-kontext-mcp"
8
- ],
9
- "env": {
10
- "RUNAPI_API_KEY": "${RUNAPI_API_KEY}"
11
- }
8
+ ]
12
9
  }
13
10
  }
14
11
  }
package/examples/vscode.mcp.json CHANGED
@@ -6,10 +6,7 @@
6
6
  "args": [
7
7
  "-y",
8
8
  "@runapi.ai/flux-kontext-mcp"
9
- ],
10
- "env": {
11
- "RUNAPI_API_KEY": "${RUNAPI_API_KEY}"
12
- }
9
+ ]
13
10
  }
14
11
  }
15
12
  }
package/examples/windsurf.mcp.json CHANGED
@@ -5,10 +5,7 @@
5
5
  "args": [
6
6
  "-y",
7
7
  "@runapi.ai/flux-kontext-mcp"
8
- ],
9
- "env": {
10
- "RUNAPI_API_KEY": "${RUNAPI_API_KEY}"
11
- }
8
+ ]
12
9
  }
13
10
  }
14
11
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@runapi.ai/flux-kontext-mcp",
3
- "version": "0.1.6",
3
+ "version": "0.1.8",
4
4
  "description": "RunAPI Flux Kontext MCP server for image generation: create tasks, poll results, and check pricing across 2 model variants from Claude Code, Codex, Cursor, and VS Code.",
5
5
  "type": "module",
6
6
  "main": "dist/src/index.js",
@@ -55,7 +55,7 @@
55
55
  },
56
56
  "dependencies": {
57
57
  "@modelcontextprotocol/sdk": "^1.29.0",
58
- "@runapi.ai/mcp-core": "0.1.3",
58
+ "@runapi.ai/mcp-core": "0.1.5",
59
59
  "zod": "^3.25.76"
60
60
  },
61
61
  "devDependencies": {
package/server.json CHANGED
@@ -6,19 +6,19 @@
6
6
  "url": "https://github.com/runapi-ai/flux-kontext-mcp",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.1.6",
9
+ "version": "0.1.8",
10
10
  "packages": [
11
11
  {
12
12
  "registryType": "npm",
13
13
  "identifier": "@runapi.ai/flux-kontext-mcp",
14
- "version": "0.1.6",
14
+ "version": "0.1.8",
15
15
  "transport": {
16
16
  "type": "stdio"
17
17
  },
18
18
  "environmentVariables": [
19
19
  {
20
- "description": "RunAPI API key. Create one at https://runapi.ai",
21
- "isRequired": true,
20
+ "description": "Optional RunAPI API key for headless hosts. Interactive MCP hosts can use the login tool, which writes shared RunAPI config.",
21
+ "isRequired": false,
22
22
  "format": "string",
23
23
  "isSecret": true,
24
24
  "name": "RUNAPI_API_KEY"