@wezzard/mcp-x-articles 0.2.4 → 0.3.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.
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/.cursor-plugin/plugin.json +10 -15
- package/README.md +12 -10
- package/dist/server.mjs +928 -601
- package/mcp_config.json +12 -18
- package/package.json +1 -1
- package/pi-mcp.json +1 -1
- package/plugin.json +1 -1
- package/skills/x-articles/SKILL.md +3 -3
package/mcp_config.json
CHANGED
|
@@ -7,31 +7,25 @@
|
|
|
7
7
|
],
|
|
8
8
|
"cwd": ".",
|
|
9
9
|
"env": {
|
|
10
|
-
"
|
|
11
|
-
"
|
|
12
|
-
"
|
|
13
|
-
"X_OAUTH_ACCESS_TOKEN_SECRET": "${X_OAUTH_ACCESS_TOKEN_SECRET}"
|
|
10
|
+
"X_OAUTH2_CLIENT_ID": "${X_OAUTH2_CLIENT_ID}",
|
|
11
|
+
"X_OAUTH2_CLIENT_SECRET": "${X_OAUTH2_CLIENT_SECRET}",
|
|
12
|
+
"X_OAUTH2_REFRESH_TOKEN": "${X_OAUTH2_REFRESH_TOKEN}"
|
|
14
13
|
},
|
|
15
14
|
"variables": [
|
|
16
15
|
{
|
|
17
|
-
"name": "
|
|
18
|
-
"title": "X
|
|
19
|
-
"description": "
|
|
16
|
+
"name": "X_OAUTH2_CLIENT_ID",
|
|
17
|
+
"title": "X OAuth 2.0 Client ID",
|
|
18
|
+
"description": "Client ID under 'OAuth 2.0 Keys' in https://console.x.com -> Apps -> Keys and tokens."
|
|
20
19
|
},
|
|
21
20
|
{
|
|
22
|
-
"name": "
|
|
23
|
-
"title": "X
|
|
24
|
-
"description": "
|
|
21
|
+
"name": "X_OAUTH2_CLIENT_SECRET",
|
|
22
|
+
"title": "X OAuth 2.0 Client Secret (Optional for public clients)",
|
|
23
|
+
"description": "Client Secret under 'OAuth 2.0 Keys' in https://console.x.com -> Apps -> Keys and tokens (optional for public PKCE clients)."
|
|
25
24
|
},
|
|
26
25
|
{
|
|
27
|
-
"name": "
|
|
28
|
-
"title": "X
|
|
29
|
-
"description": "
|
|
30
|
-
},
|
|
31
|
-
{
|
|
32
|
-
"name": "X_OAUTH_ACCESS_TOKEN_SECRET",
|
|
33
|
-
"title": "X Access Token Secret (Optional — leave blank to authorize in browser)",
|
|
34
|
-
"description": "Access Token Secret with Read and Write permissions under 'Authentication Tokens' in https://console.x.com -> Apps -> Keys and tokens."
|
|
26
|
+
"name": "X_OAUTH2_REFRESH_TOKEN",
|
|
27
|
+
"title": "X OAuth 2.0 Refresh Token (Optional — paste from Console 'Generate', or leave blank for browser PKCE login)",
|
|
28
|
+
"description": "Optional long-term OAuth 2.0 Refresh Token from 'OAuth 2.0 Keys -> Access Token -> Generate' in https://console.x.com (recommended for zero-callback long-term auth, or leave blank to authorize via browser PKCE)."
|
|
35
29
|
}
|
|
36
30
|
]
|
|
37
31
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@wezzard/mcp-x-articles",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "MCP server and multi-agent plugin for publishing Markdown files as X Articles via the official X API v2 Articles endpoints: deterministic Markdown conversion, zero-token media upload, macOS Keychain secret storage, and two-step human review.",
|
|
6
6
|
"license": "MIT",
|
package/pi-mcp.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"mcpServers":{"x-articles":{"command":"npx","args":["-y","@wezzard/mcp-x-articles@0.
|
|
1
|
+
{"mcpServers":{"x-articles":{"command":"npx","args":["-y","@wezzard/mcp-x-articles@0.3.0"],"lifecycle":"lazy","directTools":true,"toolPrefix":"none"}}}
|
package/plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcp-x-articles",
|
|
3
3
|
"displayName": "X Articles",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.3.0",
|
|
5
5
|
"description": "Publish Markdown files as X Articles via official X API v2: deterministic conversion, zero-token image upload, macOS Keychain secret storage, and two-step human review.",
|
|
6
6
|
"logo": "assets/logo.svg",
|
|
7
7
|
"author": {
|
|
@@ -5,11 +5,11 @@ description: Publish a local Markdown file as an X Article via @wezzard/mcp-x-ar
|
|
|
5
5
|
|
|
6
6
|
# x-articles
|
|
7
7
|
|
|
8
|
-
Publish a Markdown file as an X Article through the `@wezzard/mcp-x-articles` MCP tools.
|
|
8
|
+
Publish a Markdown file as an X Article through the `@wezzard/mcp-x-articles` MCP tools using OAuth 2.0 User Context (PKCE + long-term rotating `offline.access` refresh tokens).
|
|
9
9
|
|
|
10
10
|
1. Call `x_article_auth_status` if authentication is unverified:
|
|
11
|
-
- If the host agent has a native MCP plugin configuration UI (`has_native_config_ui: true`, e.g. Antigravity `[X Articles](customization://x-articles)` or Cursor) and credentials are not yet configured, **do not** open the localhost `/setup` web UI; instead, give the user the `native_config_ui_url` link (`[X Articles](customization://x-articles)`) so they can configure
|
|
12
|
-
- Only call `x_article_auth_status({ login: true })` when `has_native_config_ui` is `false` (to open the fallback local browser `/setup` card for agents without a native plugin config UI), or when `configured: true` and `token_cached: false` and the user wants to authorize
|
|
11
|
+
- If the host agent has a native MCP plugin configuration UI (`has_native_config_ui: true`, e.g. Antigravity `[X Articles](customization://x-articles)` or Cursor) and credentials are not yet configured, **do not** open the localhost `/setup` web UI; instead, give the user the `native_config_ui_url` link (`[X Articles](customization://x-articles)`) so they can configure `X_OAUTH2_CLIENT_ID`, optional `X_OAUTH2_CLIENT_SECRET`, and optional `X_OAUTH2_REFRESH_TOKEN` (from `console.x.com` → `OAuth 2.0 Keys` → `Access Token` → `Generate`) in the host's plugin settings UI.
|
|
12
|
+
- Only call `x_article_auth_status({ login: true })` when `has_native_config_ui` is `false` (to open the fallback local browser `/setup` card for agents without a native plugin config UI), or when `configured: true` and `token_cached: false` and the user wants to authorize via browser PKCE login with `offline.access` instead of pasting `X_OAUTH2_REFRESH_TOKEN` in the plugin UI.
|
|
13
13
|
2. Call `x_article_preflight({ markdown_path, cover_image_path })` first, and visually inspect every image in `images_for_visual_review` for live credentials, financial balances, account IDs, email addresses, real names, or private file paths.
|
|
14
14
|
3. **Checkpoint 1:** Whenever preflight reports text `findings`, visual sensitivities, or conversion `warnings`, ask the user with your dedicated ask-user-question tool (or directly in conversation) to rule on each item before uploading anything to X.
|
|
15
15
|
4. Call `x_article_create_draft({ markdown_path, preflight_token, cover_image_path })` and share the returned `editor_url` (`https://x.com/compose/articles/edit/<article_id>`).
|