artifactsend 1.0.0 → 1.0.1

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
@@ -2,10 +2,11 @@
2
2
 
3
3
  **Share a document, pitch deck, HTML page or Claude artifact as a link, and see who read it.** Each reader, how far they read, time per section or slide, clicks, copied text, and the questions they asked. A free DocSend alternative, built for agents: an MCP server, agent skills, a Claude Code plugin and a CLI.
4
4
 
5
- - Website: https://artifactsend.com
5
+ - Website: https://artifactsend.com/?utm_source=npm&utm_medium=readme&utm_campaign=setup
6
+ - For agents: https://artifactsend.com/agents?utm_source=npm&utm_medium=readme&utm_campaign=setup
6
7
  - MCP server: `https://artifactsend.com/mcp` (Streamable HTTP, OAuth)
7
8
  - Official MCP registry: `com.artifactsend/mcp`
8
- - For agents: https://artifactsend.com/llms.txt
9
+ - llms.txt: https://artifactsend.com/llms.txt?utm_source=npm&utm_medium=readme&utm_campaign=setup
9
10
 
10
11
  ## When an agent should use it
11
12
 
@@ -22,7 +23,7 @@
22
23
  | --- | --- |
23
24
  | Claude Code | `claude mcp add --transport http artifactsend https://artifactsend.com/mcp`, then `/mcp` to sign in |
24
25
  | Every agent on this computer | `npx artifactsend setup` (Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Codex, plus the skills) |
25
- | Skills | `npx skills add LLM-preneur/skills` |
26
+ | Skills | `npx skills add llm-preneur/skills` |
26
27
  | Claude Code plugin | `/plugin marketplace add LLM-preneur/skills`, then `/plugin install artifactsend@llm-preneur` |
27
28
  | Cursor | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=artifactsend&config=eyJ1cmwiOiJodHRwczovL2FydGlmYWN0c2VuZC5jb20vbWNwIn0=) |
28
29
  | VS Code | [Add to VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=artifactsend&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//artifactsend.com/mcp%22%7D) |
@@ -42,11 +43,37 @@ Sign in once with your email or Google. Links, readers and reports are free.
42
43
  | [data-room](https://github.com/LLM-preneur/skills/tree/main/skills/data-room/SKILL.md) | several documents behind one link, with folders, an NDA and watermarks |
43
44
  | [read-shared-link](https://github.com/LLM-preneur/skills/tree/main/skills/read-shared-link/SKILL.md) | someone sent you an artifactsend.com link |
44
45
 
46
+ ## Questions
47
+
48
+ ### Is there a Claude Code skill to publish an HTML file to a URL?
49
+
50
+ Yes. The `share-with-tracking` skill publishes an HTML file, Markdown, a PDF, Word, PowerPoint or Excel file, or a Claude artifact to an artifactsend.com link. It sends the page's images, fonts, CSS, JS and video along by relative path. Install it with `npx skills add llm-preneur/skills`, or add the MCP server with `claude mcp add --transport http artifactsend https://artifactsend.com/mcp`.
51
+
52
+ ### Which MCP server returns a tracked link?
53
+
54
+ ArtifactSend, at `https://artifactsend.com/mcp`. `send_artifact` returns the link and its settings. `link_report` shows each reader, how far they read, time per section, clicks, copied text and what their AI asked. `link_for_person` makes one link per investor or client.
55
+
56
+ ### Can Claude Code update a published page?
57
+
58
+ Yes. `update_artifact` pushes a new version to the same URL, and readers see it at once. `get_artifact` returns the current HTML. `upload_file` replaces one file. From the CLI, `npx artifactsend send page.html --link <link>` does the same.
59
+
60
+ ### Is it free?
61
+
62
+ Yes. Links, readers, doors, reports and data rooms are free and unlimited, with no card. Sending and updating through MCP or the CLI is free. Reports and lists through MCP are free for the first 20 actions, then $0.005 each. AI answers to readers are $0.05 each. Sign-in with email or Google is needed once.
63
+
64
+ ### Can it make expiring or password-protected links?
65
+
66
+ Yes. `--expires 14` (or `expires_in_days`) closes a link after 14 days. `--access verified` makes readers prove their email with Google or a 6-digit code. `--allow @acme.com` limits it to one domain. A password can be added in the app, under More settings on the link.
67
+
68
+ ### How do I set it up in ChatGPT?
69
+
70
+ Settings, Apps, Developer mode on, Create app. Use the URL `https://artifactsend.com/mcp` with OAuth, then sign in.
71
+
45
72
  ## MCP tools
46
73
 
47
- **Share:** `send_artifact` (HTML, React, Markdown, PDF, Word, PowerPoint, Excel or a URL), `update_artifact`, `link_for_person`, `make_data_room`, `upload_file`, `get_artifact`, `update_link`.
74
+ **Share:** `send_artifact` (HTML, React, Markdown, PDF, Word, PowerPoint, Excel, an image or a URL), `update_artifact`, `link_for_person`, `make_data_room`, `upload_file`, `get_artifact`, `update_link`, `set_brand`.
48
75
 
49
- **See who read it:** `list_links`, `link_report`, `reader_activity`, `recent_activity`, `room_report`, `list_questions`, `list_comments`, `website_visits`, `schedule_digest`.
76
+ **See who read it:** `list_links`, `link_report`, `reader_activity`, `recent_activity`, `room_report`, `list_questions`, `list_comments`, `website_visits`, `schedule_digest`, `list_schedules`, `delete_schedule`.
50
77
 
51
78
  **Read what others share with you:** `open_link`, `read_shared`, `ask_shared`, `message_shared_sender`, `shared_with_me`.
52
79
 
@@ -56,7 +83,7 @@ Reading tools are marked read-only. Tools that change things are marked so the a
56
83
 
57
84
  ```bash
58
85
  npx artifactsend setup # add ArtifactSend to your agents
59
- export ARTIFACTSEND_TOKEN=as_... # from https://artifactsend.com/app/settings
86
+ export ARTIFACTSEND_TOKEN=as_... # from https://artifactsend.com/app/settings?utm_source=npm&utm_medium=readme&utm_campaign=setup
60
87
  npx artifactsend send deck.pdf --title "Seed deck" --access email
61
88
  npx artifactsend send page.html --allow @acme.com --expires 14
62
89
  npx artifactsend links
@@ -65,10 +92,10 @@ npx artifactsend report https://artifactsend.com/d/ab12cd34
65
92
 
66
93
  ## Readers and their AI
67
94
 
68
- Readers open a link in the browser, or through their own AI. Every link also has its own MCP address (the link plus `/mcp`) that needs no key. By default a reader's AI gets the outline and only the parts that answer each question, so the sender sees every question and no full copy leaves. Readers are told what the sender sees, and never their chat or their AI's answers. Rules: https://artifactsend.com/ai-rules
95
+ Readers open a link in the browser, or through their own AI. Every link also has its own MCP address (the link plus `/mcp`) that needs no key. By default a reader's AI gets the outline and only the parts that answer each question, so the sender sees every question and no full copy leaves. Readers are told what the sender sees, and never their chat or their AI's answers. Rules: https://artifactsend.com/ai-rules?utm_source=npm&utm_medium=readme&utm_campaign=setup
69
96
 
70
97
  ## Price
71
98
 
72
- Free and unlimited for links, readers, doors, reports and data rooms. Sending and updating through MCP is free. AI answers to readers are paid per answer. https://artifactsend.com/pricing
99
+ Free and unlimited for links, readers, doors, reports and data rooms. Sending and updating through MCP is free. AI answers to readers are paid per answer. https://artifactsend.com/pricing?utm_source=npm&utm_medium=readme&utm_campaign=setup
73
100
 
74
101
  Made by [Vela Partners](https://vela.partners). MIT licensed.
@@ -9,8 +9,10 @@ import { createInterface } from 'node:readline';
9
9
 
10
10
  const ORIGIN = (process.env.ARTIFACTSEND_URL || 'https://artifactsend.com').replace(/\/$/, '');
11
11
  const MCP = ORIGIN + '/mcp';
12
+ // Pages people open from the CLI's own output carry a source tag. Config the CLI writes keeps the bare MCP URL.
13
+ const TOKENS = ORIGIN + '/app/settings?utm_source=npm&utm_medium=cli&utm_campaign=setup';
12
14
  const SKILLS = 'LLM-preneur/skills';
13
- const VERSION = '1.0.0';
15
+ const VERSION = '1.0.1';
14
16
  const [cmd, ...rest] = process.argv.slice(2);
15
17
 
16
18
  const HELP = `ArtifactSend: the link that tells you who read it.
@@ -23,7 +25,7 @@ const HELP = `ArtifactSend: the link that tells you who read it.
23
25
  npx artifactsend report <link> Who read it, how far, time per section, what they asked
24
26
  npx artifactsend mcp Run as a stdio MCP server (bridges to ${MCP})
25
27
 
26
- send, links, report and mcp need ARTIFACTSEND_TOKEN (make one at ${ORIGIN}/app/settings).
28
+ send, links, report and mcp need ARTIFACTSEND_TOKEN (make one at ${TOKENS}).
27
29
  In Claude Code you can skip the token: claude mcp add --transport http artifactsend ${MCP}, then /mcp to sign in.
28
30
  Claude.ai and ChatGPT: add a custom connector with the URL ${MCP}.`;
29
31
 
@@ -84,7 +86,7 @@ function setup(opts) {
84
86
  // ---------- MCP over HTTP ----------
85
87
  const token = () => {
86
88
  const t = process.env.ARTIFACTSEND_TOKEN;
87
- if (!t) { console.error(`Set ARTIFACTSEND_TOKEN first. Make one at ${ORIGIN}/app/settings`); process.exit(2); }
89
+ if (!t) { console.error(`Set ARTIFACTSEND_TOKEN first. Make one at ${TOKENS}`); process.exit(2); }
88
90
  return t;
89
91
  };
90
92
  let rpcId = 0;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "artifactsend",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "Share documents, decks, HTML pages and Claude artifacts as tracked links and data rooms. See who read them and what they asked. MCP server, agent skills and CLI.",
5
5
  "mcpName": "com.artifactsend/mcp",
6
6
  "type": "module",