@orchyn/mcp 1.3.1 → 1.3.3
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 +7 -7
- package/dist/index.js +6 -6
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -42,12 +42,12 @@ npx @orchyn/mcp login # one-time sign-in (Google)
|
|
|
42
42
|
| `get_social_media` | 1 | Fetch a post's media from a URL: `contentType` (video/image/carousel/slideshow), title, caption, author, stats, direct media URLs **+ inline thumbnail image in chat**. |
|
|
43
43
|
| `discover_social_posts` | 2 | **Preferred.** Find recent posts (video/image/carousel/slideshow) for a niche (YouTube via `yt-dlp` search; TikTok/Instagram via Apify). Each post includes title/caption, views/likes/comments, author, `externalUrl` + **inline thumbnails (4 at a time)** — see *Images in chat* below. Supports `limit`/`offset` pagination (“next”). |
|
|
44
44
|
| `understand_social_post` | 10 | Import a post URL **and** analyze it with multimodal AI over the actual video/images: factual `whatHappens` description, hook strength, viral triggers, format breakdown, variation ideas, suggested hook/hashtags. Includes inline thumbnails. |
|
|
45
|
-
| `
|
|
46
|
-
| `
|
|
45
|
+
| `check_orchyn_credits` | free | Check your MCP credit balance, billing URL and pack size — no cost. |
|
|
46
|
+
| `buy_orchyn_credits` | free | Get a Stripe Checkout URL to buy a credit pack — open it to pay; credits are added automatically. No cost to call. Also at `https://orchyn.com/settings?tab=billing`. |
|
|
47
47
|
|
|
48
48
|
All tools require a connected orchyn account and are billed against your orchyn credit balance (`POST /billing/mcp-credits/checkout` tops up).
|
|
49
49
|
|
|
50
|
-
`*` `analyze_post
|
|
50
|
+
`*` `analyze_post` bills against **workspace** credits (first free grant); the other tools bill against **per-user MCP** credits (never tied to an app/workspace).
|
|
51
51
|
|
|
52
52
|
## Images in Claude / ChatGPT chat
|
|
53
53
|
|
|
@@ -246,7 +246,7 @@ per the MCP 2025-03-26 spec):
|
|
|
246
246
|
- YouTube: `youtube.com/*` (including `/shorts/`), `youtu.be/*`, `m.youtube.com/*`
|
|
247
247
|
- X/Twitter: `x.com/*`, `twitter.com/*`
|
|
248
248
|
|
|
249
|
-
All tools accept these hosts
|
|
249
|
+
All tools accept these hosts and handle **video, image, carousel and slideshow** posts.
|
|
250
250
|
|
|
251
251
|
## Troubleshooting
|
|
252
252
|
|
|
@@ -254,9 +254,9 @@ All tools accept these hosts. `analyze_post` (and its `analyze_video` alias) add
|
|
|
254
254
|
`ORCHYN_ACCESS_TOKEN`.
|
|
255
255
|
- **402 paywall / `insufficient MCP credits`**: your orchyn account is out of
|
|
256
256
|
credits for this tool. Each call costs: `get_social_media` 1,
|
|
257
|
-
`
|
|
258
|
-
|
|
259
|
-
|
|
257
|
+
`discover_social_posts` 2, `understand_social_post` 10, `analyze_post`
|
|
258
|
+
first-call free* (see Tools). Top up via `buy_orchyn_credits`, `check_orchyn_credits`,
|
|
259
|
+
or the orchyn dashboard at `https://orchyn.com/settings?tab=billing`.
|
|
260
260
|
- **Expired refresh token**: the stored refresh token was rejected by the
|
|
261
261
|
orchyn server. Run `npx @orchyn/mcp login` again to re-authenticate.
|
|
262
262
|
- **`Could not reach the orchyn server`**: `ORCHYN_BASE_URL` is unreachable or
|
package/dist/index.js
CHANGED
|
@@ -122,30 +122,30 @@ export function createServer(opts) {
|
|
|
122
122
|
return toolError("discover_social_posts failed", err);
|
|
123
123
|
}
|
|
124
124
|
});
|
|
125
|
-
server.registerTool("
|
|
125
|
+
server.registerTool("check_orchyn_credits", {
|
|
126
126
|
title: "Check MCP Credits",
|
|
127
127
|
description: "Check your MCP credit balance, billing URL and pack size. No cost — call anytime to see remaining credits before running other tools.",
|
|
128
128
|
inputSchema: z.object({}).strict(),
|
|
129
129
|
}, async (_args, extra) => {
|
|
130
130
|
const client = makeClientFor(extra, opts);
|
|
131
131
|
try {
|
|
132
|
-
return toToolResult(await client.callTool("
|
|
132
|
+
return toToolResult(await client.callTool("check_orchyn_credits", {}));
|
|
133
133
|
}
|
|
134
134
|
catch (err) {
|
|
135
|
-
return toolError("
|
|
135
|
+
return toolError("check_orchyn_credits failed", err);
|
|
136
136
|
}
|
|
137
137
|
});
|
|
138
|
-
server.registerTool("
|
|
138
|
+
server.registerTool("buy_orchyn_credits", {
|
|
139
139
|
title: "Buy MCP Credits",
|
|
140
140
|
description: "Buy an MCP credit pack via Stripe Checkout. Returns a secure checkout URL — open it in your browser to pay. Credits are added automatically after payment. No cost to call.",
|
|
141
141
|
inputSchema: z.object({}).strict(),
|
|
142
142
|
}, async (_args, extra) => {
|
|
143
143
|
const client = makeClientFor(extra, opts);
|
|
144
144
|
try {
|
|
145
|
-
return toToolResult(await client.callTool("
|
|
145
|
+
return toToolResult(await client.callTool("buy_orchyn_credits", {}));
|
|
146
146
|
}
|
|
147
147
|
catch (err) {
|
|
148
|
-
return toolError("
|
|
148
|
+
return toolError("buy_orchyn_credits failed", err);
|
|
149
149
|
}
|
|
150
150
|
});
|
|
151
151
|
server.registerTool("understand_social_post", {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@orchyn/mcp",
|
|
3
|
-
"version": "1.3.
|
|
3
|
+
"version": "1.3.3",
|
|
4
4
|
"description": "MCP server for orchyn - fetch, discover and understand TikTok/Instagram/YouTube/X posts with AI (media metadata, niche discovery, hook & viral analysis)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|