@seldonframe/mcp 1.0.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/README.md +112 -0
- package/package.json +42 -0
- package/src/client.js +194 -0
- package/src/index.js +49 -0
- package/src/tools.js +2001 -0
- package/src/welcome.js +80 -0
package/src/welcome.js
ADDED
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
export const VERSION = "1.0.0";
|
|
2
|
+
|
|
3
|
+
export const WELCOME_MARKDOWN = `# SeldonFrame — your AI-native Business OS
|
|
4
|
+
|
|
5
|
+
One command creates a real, hosted workspace with CRM, Cal.diy booking,
|
|
6
|
+
Formbricks intake, and Brain v2 — live on \`<slug>.app.seldonframe.com\`.
|
|
7
|
+
No signup, no key, no setup. Just build.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Architecture: YOU are the reasoning engine
|
|
12
|
+
|
|
13
|
+
SeldonFrame's backend is pure state + artifacts. Natural-language reasoning
|
|
14
|
+
happens right here in this Claude Code session — YOU interpret the user's
|
|
15
|
+
intent and call the appropriate typed tool. The backend applies the change
|
|
16
|
+
deterministically. Zero backend LLM cost means the free tier is genuinely
|
|
17
|
+
free forever.
|
|
18
|
+
|
|
19
|
+
## The one command
|
|
20
|
+
|
|
21
|
+
\`\`\`text
|
|
22
|
+
create_workspace({ name: "Dental Clinic Laval", source: "https://example.com" })
|
|
23
|
+
\`\`\`
|
|
24
|
+
|
|
25
|
+
Returns a live subdomain, seeded CRM, and booking + intake pages ready to share.
|
|
26
|
+
|
|
27
|
+
## How to customize a workspace
|
|
28
|
+
|
|
29
|
+
1. Call \`get_workspace_snapshot({})\` to see current state, Soul, blocks, recent events.
|
|
30
|
+
2. Decide what to change based on the user's intent.
|
|
31
|
+
3. Call the right typed tool:
|
|
32
|
+
- \`update_landing_content({ headline, subhead, cta_label })\` — rewrite /
|
|
33
|
+
- \`customize_intake_form({ fields: [...] })\` — replace intake fields
|
|
34
|
+
- \`configure_booking({ title?, duration_minutes?, description? })\` — edit /book
|
|
35
|
+
- \`update_theme({ mode?, primary_color?, accent_color?, font_family? })\` — theme
|
|
36
|
+
- \`install_caldiy_booking({})\`, \`install_formbricks_intake({})\`, \`install_vertical_pack({ pack })\`
|
|
37
|
+
|
|
38
|
+
## Compiling a Soul from a URL
|
|
39
|
+
|
|
40
|
+
Soul compilation runs HERE, not on the backend:
|
|
41
|
+
|
|
42
|
+
1. \`fetch_source_for_soul({ url })\` — backend scrapes + normalizes (up to 256KB).
|
|
43
|
+
2. YOU extract a structured Soul (mission, audience, tone, offerings, ...).
|
|
44
|
+
3. \`submit_soul({ soul })\` — persist it. Subsequent snapshots reflect it.
|
|
45
|
+
|
|
46
|
+
## Tool surface
|
|
47
|
+
|
|
48
|
+
- **Workspace:** \`create_workspace\`, \`list_workspaces\`, \`switch_workspace\`,
|
|
49
|
+
\`clone_workspace\`, \`link_workspace_owner\`, \`get_workspace_snapshot\`
|
|
50
|
+
- **Blocks:** \`install_caldiy_booking\`, \`install_formbricks_intake\`, \`install_vertical_pack\`
|
|
51
|
+
- **Customize:** \`update_landing_content\`, \`customize_intake_form\`,
|
|
52
|
+
\`configure_booking\`, \`update_theme\`
|
|
53
|
+
- **Soul:** \`fetch_source_for_soul\`, \`submit_soul\`
|
|
54
|
+
- **Ops:** \`list_automations\`, \`connect_custom_domain\`, \`export_agent\`,
|
|
55
|
+
\`store_secret\`, \`list_secrets\`, \`rotate_secret\`
|
|
56
|
+
|
|
57
|
+
## When you'll need \`SELDONFRAME_API_KEY\`
|
|
58
|
+
|
|
59
|
+
The first workspace is free forever. A key is only required for:
|
|
60
|
+
|
|
61
|
+
- Adding a **second workspace**
|
|
62
|
+
- Connecting a **custom domain**
|
|
63
|
+
- Publishing, exporting agents, rotating org-scoped secrets
|
|
64
|
+
|
|
65
|
+
Get one at <https://app.seldonframe.com/settings/api> and
|
|
66
|
+
\`export SELDONFRAME_API_KEY=sk-…\`. The MCP will pick it up on next restart.
|
|
67
|
+
|
|
68
|
+
### Upgrading an anonymous workspace to your account
|
|
69
|
+
|
|
70
|
+
Once a key is set, \`link_workspace_owner({})\` attaches the active
|
|
71
|
+
workspace to your real account. This unlocks the admin URLs
|
|
72
|
+
(dashboard, contacts, deals) for browser use after sign-in. The MCP
|
|
73
|
+
bearer token stays valid — no rotation needed.
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
**Docs:** <https://app.seldonframe.com/docs> · **Homepage:** <https://seldonframe.com>
|
|
78
|
+
`;
|
|
79
|
+
|
|
80
|
+
export const FIRST_CALL_BANNER = `🌑 Welcome to SeldonFrame. Your workspace is live — every URL above works right now. From here on, every tool response will include a \`next:\` array; follow it and you'll have a production-ready Business OS in under a minute.`;
|