schedpilot-mcp 1.0.0 → 1.1.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 (2) hide show
  1. package/README.md +192 -0
  2. package/package.json +1 -1
package/README.md ADDED
@@ -0,0 +1,192 @@
1
+ # schedpilot-mcp
2
+
3
+ [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for [SchedPilot](https://schedpilot.com) — lets AI agents schedule and manage social media posts on your connected accounts.
4
+
5
+ Tested with **Claude Desktop**, **Claude Code**, **Hermes**, **Cursor**, and **Windsurf**.
6
+
7
+ ---
8
+
9
+ ## What agents can do
10
+
11
+ - List all connected social media accounts
12
+ - Schedule posts with text, images, or video
13
+ - List and filter scheduled / published posts
14
+ - Delete scheduled posts
15
+ - Upload media from a public URL
16
+ - Retrieve post analytics (impressions, reach, likes, comments, shares)
17
+
18
+ ---
19
+
20
+ ## Requirements
21
+
22
+ - Node.js v18 or later
23
+ - A SchedPilot account with an active subscription
24
+ - A SchedPilot API key (`smm_...`) — get one at [app.schedpilot.com/api-access](https://app.schedpilot.com/api-access)
25
+
26
+ ---
27
+
28
+ ## Setup
29
+
30
+ ### Claude Desktop
31
+
32
+ Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
33
+
34
+ ```json
35
+ {
36
+ "mcpServers": {
37
+ "schedpilot": {
38
+ "command": "npx",
39
+ "args": ["-y", "schedpilot-mcp"],
40
+ "env": {
41
+ "SCHEDPILOT_TOKEN": "smm_your_key_here"
42
+ }
43
+ }
44
+ }
45
+ }
46
+ ```
47
+
48
+ Fully quit and relaunch Claude Desktop. Look for the 🔧 icon in the chat input to confirm the tools loaded.
49
+
50
+ ---
51
+
52
+ ### Claude Code
53
+
54
+ ```bash
55
+ claude mcp add schedpilot -s user -e SCHEDPILOT_TOKEN=smm_your_key_here -- npx -y schedpilot-mcp
56
+ ```
57
+
58
+ Verify it loaded:
59
+
60
+ ```bash
61
+ claude mcp list
62
+ ```
63
+
64
+ ---
65
+
66
+ ### Hermes
67
+
68
+ Add to your Hermes `mcp_config.json`:
69
+
70
+ ```json
71
+ {
72
+ "mcpServers": {
73
+ "schedpilot": {
74
+ "command": "npx",
75
+ "args": ["-y", "schedpilot-mcp"],
76
+ "env": {
77
+ "SCHEDPILOT_TOKEN": "smm_your_key_here"
78
+ }
79
+ }
80
+ }
81
+ }
82
+ ```
83
+
84
+ ---
85
+
86
+ ### Cursor
87
+
88
+ Add to `~/.cursor/mcp.json`:
89
+
90
+ ```json
91
+ {
92
+ "mcpServers": {
93
+ "schedpilot": {
94
+ "command": "npx",
95
+ "args": ["-y", "schedpilot-mcp"],
96
+ "env": {
97
+ "SCHEDPILOT_TOKEN": "smm_your_key_here"
98
+ }
99
+ }
100
+ }
101
+ }
102
+ ```
103
+
104
+ ---
105
+
106
+ ### Windsurf
107
+
108
+ Add to `~/.codeium/windsurf/mcp_config.json`:
109
+
110
+ ```json
111
+ {
112
+ "mcpServers": {
113
+ "schedpilot": {
114
+ "command": "npx",
115
+ "args": ["-y", "schedpilot-mcp"],
116
+ "env": {
117
+ "SCHEDPILOT_TOKEN": "smm_your_key_here"
118
+ }
119
+ }
120
+ }
121
+ }
122
+ ```
123
+
124
+ ---
125
+
126
+ ## Authentication
127
+
128
+ Set `SCHEDPILOT_TOKEN` to either:
129
+
130
+ | Type | Format | How to get |
131
+ |------|--------|-----------|
132
+ | Personal API key | `smm_...` | [app.schedpilot.com/api-access](https://app.schedpilot.com/api-access) → Create Key |
133
+ | OAuth access token | `sp_tok_...` | Complete the [OAuth 2.0 flow](https://docs.schedpilot.com/docs/authentication/oauth) |
134
+
135
+ Both formats are accepted interchangeably.
136
+
137
+ ---
138
+
139
+ ## Tools
140
+
141
+ | Tool | Description |
142
+ |------|-------------|
143
+ | `get_accounts` | List all connected social media accounts with their IDs and types |
144
+ | `list_posts` | List posts filtered by status, date range, and pagination |
145
+ | `create_post` | Schedule a post to one or more accounts with optional media |
146
+ | `delete_post` | Cancel and delete a scheduled post (cannot delete published posts) |
147
+ | `upload_media` | Upload an image or video from a public URL; returns a `media_id` |
148
+ | `get_analytics` | Get impressions, reach, likes, comments, shares for a published post |
149
+
150
+ Full parameter reference: [docs.schedpilot.com/docs/ai-agents/mcp-tools](https://docs.schedpilot.com/docs/ai-agents/mcp-tools)
151
+
152
+ ---
153
+
154
+ ## Example prompts
155
+
156
+ ```
157
+ Show me my SchedPilot accounts
158
+ ```
159
+
160
+ ```
161
+ Schedule a LinkedIn post saying "Excited to share our Q2 results!" for tomorrow at 9am Eastern time
162
+ ```
163
+
164
+ ```
165
+ Upload the image at https://example.com/banner.jpg and post it to Twitter and Instagram on Friday at 11am UTC
166
+ ```
167
+
168
+ ```
169
+ Show me all posts that failed to publish in the last 7 days
170
+ ```
171
+
172
+ ```
173
+ Get analytics for post 142
174
+ ```
175
+
176
+ ---
177
+
178
+ ## Rate limits
179
+
180
+ | Type | Limit |
181
+ |------|-------|
182
+ | Read requests (`get_accounts`, `list_posts`, `get_analytics`) | 60 / hour |
183
+ | Write requests (`create_post`, `delete_post`, `upload_media`) | 30 / hour |
184
+
185
+ ---
186
+
187
+ ## Links
188
+
189
+ - [SchedPilot](https://schedpilot.com)
190
+ - [Full API Documentation](https://docs.schedpilot.com)
191
+ - [MCP Tools Reference](https://docs.schedpilot.com/docs/ai-agents/mcp-tools)
192
+ - [OAuth 2.0 Guide](https://docs.schedpilot.com/docs/authentication/oauth)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "schedpilot-mcp",
3
- "version": "1.0.0",
3
+ "version": "1.1.0",
4
4
  "description": "Model Context Protocol server for SchedPilot — schedule and manage social media posts via AI agents",
5
5
  "type": "module",
6
6
  "main": "server.js",