@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 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
- | `check_mcp_credits` | free | Check your MCP credit balance, billing URL and pack size — no cost. |
46
- | `buy_mcp_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`. |
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`/`analyze_video` bill against **workspace** credits (first free grant); the other three bill against **per-user MCP** credits (never tied to an app/workspace).
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. `analyze_post` (and its `analyze_video` alias) additionally handles **image, carousel and slideshow** posts — not just video.
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
- `discover_social_videos` 2, `understand_social_post` 10, `analyze_post`/
258
- `analyze_video` first-call free* (see Tools). Top up via the orchyn dashboard
259
- billing page or `POST /billing/mcp-credits/checkout`.
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("check_mcp_credits", {
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("check_mcp_credits", {}));
132
+ return toToolResult(await client.callTool("check_orchyn_credits", {}));
133
133
  }
134
134
  catch (err) {
135
- return toolError("check_mcp_credits failed", err);
135
+ return toolError("check_orchyn_credits failed", err);
136
136
  }
137
137
  });
138
- server.registerTool("buy_mcp_credits", {
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("buy_mcp_credits", {}));
145
+ return toToolResult(await client.callTool("buy_orchyn_credits", {}));
146
146
  }
147
147
  catch (err) {
148
- return toolError("buy_mcp_credits failed", err);
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.1",
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",