@jclvsh/dropspace 2.0.0 → 2.0.2
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.
- package/README.md +47 -8
- package/dist/client.js +1 -1
- package/dist/tools/launches.js +0 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,20 +1,57 @@
|
|
|
1
1
|
# @jclvsh/dropspace
|
|
2
2
|
|
|
3
|
-
MCP server and CLI for the [Dropspace](https://dropspace.dev) API. Lets AI agents (Claude Code, Cursor) and humans manage launches, personas, platform connections, API keys, and webhooks.
|
|
3
|
+
MCP server and CLI for the [Dropspace](https://www.dropspace.dev) API. Lets AI agents (Claude Code, Cursor) and humans manage launches, personas, platform connections, API keys, and webhooks.
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
|
-
|
|
8
|
+
npm install -g @jclvsh/dropspace
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
This installs two binaries:
|
|
12
|
+
- `dropspace` — CLI for terminal use
|
|
13
|
+
- `dropspace-mcp` — MCP server for AI agents
|
|
14
|
+
|
|
15
|
+
## CLI
|
|
12
16
|
|
|
13
17
|
```bash
|
|
14
|
-
|
|
18
|
+
# set your API key
|
|
19
|
+
export DROPSPACE_API_KEY=ds_live_...
|
|
20
|
+
|
|
21
|
+
# manage launches
|
|
22
|
+
dropspace launches list
|
|
23
|
+
dropspace launches create -t "my launch" --platforms twitter,reddit --publish
|
|
24
|
+
dropspace launches status <id>
|
|
25
|
+
dropspace launches analytics <id>
|
|
26
|
+
|
|
27
|
+
# manage personas
|
|
28
|
+
dropspace personas list
|
|
29
|
+
dropspace personas create -n "my brand voice"
|
|
30
|
+
|
|
31
|
+
# check your key
|
|
32
|
+
dropspace keys me
|
|
33
|
+
|
|
34
|
+
# table output
|
|
35
|
+
dropspace --format table launches list
|
|
36
|
+
|
|
37
|
+
# full help
|
|
38
|
+
dropspace --help
|
|
39
|
+
dropspace launches --help
|
|
15
40
|
```
|
|
16
41
|
|
|
17
|
-
|
|
42
|
+
### CLI Commands
|
|
43
|
+
|
|
44
|
+
| Group | Commands | Count |
|
|
45
|
+
| --- | --- | --- |
|
|
46
|
+
| launches | list, create, get, update, delete, publish, retry, generate, retry-content, analytics, batch-analytics, status, delete-post, delete-posts | 14 |
|
|
47
|
+
| personas | list, create, get, update, delete, analyze | 6 |
|
|
48
|
+
| connections | list | 1 |
|
|
49
|
+
| keys | me, list, create, rename, revoke | 5 |
|
|
50
|
+
| webhooks | list, create, get, update, delete, rotate-secret, deliveries | 7 |
|
|
51
|
+
| status | dropspace official account connections | 1 |
|
|
52
|
+
| usage | plan, limits, and billing period | 1 |
|
|
53
|
+
|
|
54
|
+
## MCP Server Configuration
|
|
18
55
|
|
|
19
56
|
### Environment Variables
|
|
20
57
|
|
|
@@ -23,6 +60,8 @@ npm install -g @jclvsh/dropspace
|
|
|
23
60
|
| `DROPSPACE_API_KEY` | Yes | Your Dropspace API key |
|
|
24
61
|
| `DROPSPACE_API_URL` | No | API base URL (default: `https://api.dropspace.dev`) |
|
|
25
62
|
|
|
63
|
+
> **Note:** the args use `-p @jclvsh/dropspace dropspace-mcp` to explicitly select the MCP-server bin. The package ships two binaries (`dropspace` for the CLI, `dropspace-mcp` for the MCP server), so a bare `npx @jclvsh/dropspace` would launch the CLI by default.
|
|
64
|
+
|
|
26
65
|
### Claude Code
|
|
27
66
|
|
|
28
67
|
Add to your `.claude/settings.json`:
|
|
@@ -32,7 +71,7 @@ Add to your `.claude/settings.json`:
|
|
|
32
71
|
"mcpServers": {
|
|
33
72
|
"dropspace": {
|
|
34
73
|
"command": "npx",
|
|
35
|
-
"args": ["-y", "@jclvsh/dropspace"],
|
|
74
|
+
"args": ["-y", "-p", "@jclvsh/dropspace", "dropspace-mcp"],
|
|
36
75
|
"env": {
|
|
37
76
|
"DROPSPACE_API_KEY": "ds_live_your_key_here"
|
|
38
77
|
}
|
|
@@ -50,7 +89,7 @@ Add to your `.cursor/mcp.json`:
|
|
|
50
89
|
"mcpServers": {
|
|
51
90
|
"dropspace": {
|
|
52
91
|
"command": "npx",
|
|
53
|
-
"args": ["-y", "@jclvsh/dropspace"],
|
|
92
|
+
"args": ["-y", "-p", "@jclvsh/dropspace", "dropspace-mcp"],
|
|
54
93
|
"env": {
|
|
55
94
|
"DROPSPACE_API_KEY": "ds_live_your_key_here"
|
|
56
95
|
}
|
|
@@ -226,7 +265,7 @@ Add to your `.cursor/mcp.json`:
|
|
|
226
265
|
|
|
227
266
|
## API Key & Scopes
|
|
228
267
|
|
|
229
|
-
Generate an API key at [dropspace.dev/settings](https://dropspace.dev/settings) under the API section.
|
|
268
|
+
Generate an API key at [www.dropspace.dev/settings](https://www.dropspace.dev/settings) under the API section.
|
|
230
269
|
|
|
231
270
|
API keys support scoped permissions:
|
|
232
271
|
|
package/dist/client.js
CHANGED
|
@@ -8,7 +8,7 @@ export class DropspaceClient {
|
|
|
8
8
|
throw new Error("DROPSPACE_API_KEY environment variable is required");
|
|
9
9
|
}
|
|
10
10
|
if (!apiKey.startsWith("ds_live_")) {
|
|
11
|
-
throw new Error("DROPSPACE_API_KEY must start with 'ds_live_'. Get one at https://dropspace.dev/settings");
|
|
11
|
+
throw new Error("DROPSPACE_API_KEY must start with 'ds_live_'. Get one at https://www.dropspace.dev/settings");
|
|
12
12
|
}
|
|
13
13
|
this.apiKey = apiKey;
|
|
14
14
|
this.baseUrl = (process.env.DROPSPACE_API_URL || "https://api.dropspace.dev").replace(/\/$/, "");
|
package/dist/tools/launches.js
CHANGED
|
@@ -17,7 +17,6 @@ const PLATFORMS = [
|
|
|
17
17
|
"hackernews",
|
|
18
18
|
];
|
|
19
19
|
const AUTO_POST_PLATFORMS = ["facebook", "linkedin", "twitter", "reddit", "instagram", "tiktok", "youtube"];
|
|
20
|
-
const VIDEO_GENERATION_PLATFORMS = ["instagram", "tiktok"];
|
|
21
20
|
const inlineMediaItemSchema = z.discriminatedUnion("source", [
|
|
22
21
|
z.object({
|
|
23
22
|
source: z.literal("url"),
|