@jclvsh/xmark 0.6.2 → 0.7.0

package/README.md

@@ -32,6 +32,19 @@ Optionally override the API host (default is `https://api.xmark.dev`):
 export XMARK_API_URL=https://api.xmark.dev
 ```
 
+## Hosted endpoint
+
+Clients that connect to a remote MCP server can use the hosted endpoint instead of this package:
+
+```
+https://api.xmark.dev/mcp
+```
+
+- Transport: MCP streamable HTTP, `POST` only.
+- Registry: listed in the [official MCP registry](https://registry.modelcontextprotocol.io) as `io.github.JCLVSH/xmark`.
+- Auth: `Authorization: Bearer nt_live_...` (the same API key; its scopes apply). `initialize` and `tools/list` answer without a key, so a client can read the tool list before signing up; calling a tool needs the key.
+- Tools: the class of each hosted tool is listed at https://www.xmark.dev/docs#mcp-hosted.
+
 ## Tools exposed via MCP
 
 | Tool                        | What it does                                                       |
@@ -46,6 +59,7 @@ export XMARK_API_URL=https://api.xmark.dev
 | `get_conversation_messages` | A conversation's message history.                                  |
 | `delete_conversation`       | Permanently delete a conversation.                                 |
 | `get_usage`                 | Plan + quota usage (chat this month, syncs today, bookmark count). |
+| `get_affiliate`             | Affiliate status, link, sign-ups, and commission totals (stdio only). |
 
 ## CLI commands
 
@@ -60,6 +74,7 @@ xmark conversations
 xmark messages <conversation-id>
 xmark delete-conversation <conversation-id>
 xmark usage
+xmark affiliate
 ```
 
 Global flags: `--format table` renders paginated lists as a table (default is `json`).

package/dist/commands/usage.js

@@ -12,4 +12,16 @@ export function registerUsageCommands(program, client) {
             handleError(error);
         }
     });
+    program
+        .command("affiliate")
+        .description("Your affiliate status, link, sign-ups, and commission totals")
+        .action(async () => {
+        try {
+            const result = await client.get("/affiliate");
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
 }

package/dist/tool-policy.js

@@ -5,6 +5,11 @@ const hosted = (category, toolClass) => ({
     hosted: true,
     category,
 });
+const localOnly = (category, toolClass) => ({
+    class: toolClass,
+    hosted: false,
+    category,
+});
 export const TOOL_POLICY = {
     // bookmarks
     list_bookmarks: hosted("bookmarks", "read"),
@@ -22,6 +27,9 @@ export const TOOL_POLICY = {
     // usage
     get_usage: hosted("usage", "read"),
     get_changelog: hosted("usage", "read"),
+    // stdio only for now: the hosted tool set is pinned to what is under review at Meta
+    // (__tests__/server.test.ts). Read-only; applying and payouts stay in the app and with the admin.
+    get_affiliate: localOnly("usage", "read"),
 };
 export const toolPolicy = (name) => toolPolicyFor(TOOL_POLICY, name);
 export const isToolEnabled = (name, profile) => isToolEnabledIn(TOOL_POLICY, name, profile);

package/dist/tools/usage.js

@@ -20,4 +20,13 @@ export function registerUsageTools(server, client) {
             return formatMcpError(error);
         }
     });
+    server.tool("get_affiliate", 'the user\'s affiliate status ("none" if they have not applied), code and link, sign-up count, commission totals in US cents (in the hold, payable, paid out), and the program terms. read-only; applying is done in the app at /settings/affiliate.', {}, async () => {
+        try {
+            const result = await client.get("/affiliate");
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return formatMcpError(error);
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jclvsh/xmark",
-	"version": "0.6.2",
+	"version": "0.7.0",
 	"mcpName": "io.github.JCLVSH/xmark",
 	"description": "MCP server and CLI for the xmark API — chat with your X bookmarks from inside Claude Code, Cursor, or any MCP client.",
 	"type": "module",