@graspful/mcp 0.2.0 → 0.2.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 +25 -10
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -8,9 +8,9 @@ MCP server for creating adaptive learning courses. AI agents scaffold, validate,
|
|
|
8
8
|
|
|
9
9
|
Part of [Graspful](https://graspful.ai) -- the agent-first adaptive learning platform. Courses are authored as two YAML files (graph structure + content), validated offline, then imported via API.
|
|
10
10
|
|
|
11
|
-
## Quick
|
|
11
|
+
## Quick Start
|
|
12
12
|
|
|
13
|
-
###
|
|
13
|
+
### 1. Configure your editor
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
16
|
npx @graspful/cli init
|
|
@@ -18,25 +18,40 @@ npx @graspful/cli init
|
|
|
18
18
|
|
|
19
19
|
Detects your editor (Claude Code, Cursor, Windsurf) and writes the MCP config automatically.
|
|
20
20
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
Add to your editor's MCP config (see [Editor Configuration](#editor-configuration) below):
|
|
21
|
+
Or add manually to your editor's MCP config (see [Editor Configuration](#editor-configuration) below):
|
|
24
22
|
|
|
25
23
|
```json
|
|
26
24
|
{
|
|
27
25
|
"mcpServers": {
|
|
28
26
|
"graspful": {
|
|
29
27
|
"command": "npx",
|
|
30
|
-
"args": ["@graspful/mcp"]
|
|
31
|
-
"env": {
|
|
32
|
-
"GRASPFUL_API_KEY": "gsk_your_key_here"
|
|
33
|
-
}
|
|
28
|
+
"args": ["@graspful/mcp"]
|
|
34
29
|
}
|
|
35
30
|
}
|
|
36
31
|
}
|
|
37
32
|
```
|
|
38
33
|
|
|
39
|
-
|
|
34
|
+
### 2. Create an account
|
|
35
|
+
|
|
36
|
+
Call the `graspful_register` tool with your email and password. This creates an account, org, and API key — all in one step, no browser needed.
|
|
37
|
+
|
|
38
|
+
```
|
|
39
|
+
graspful_register(email: "you@example.com", password: "your-password")
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Or via CLI: `npx @graspful/cli register --email you@example.com --password your-password`
|
|
43
|
+
|
|
44
|
+
### 3. Build a course
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
graspful_scaffold_course(topic: "Your Topic", estimatedHours: 10)
|
|
48
|
+
→ edit the YAML
|
|
49
|
+
graspful_validate(yaml: "...")
|
|
50
|
+
graspful_review_course(yaml: "...")
|
|
51
|
+
graspful_import_course(yaml: "...", org: "your-org", publish: true)
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Scaffold, fill, validate, and review work offline — no account needed. You only need to register before importing or publishing.
|
|
40
55
|
|
|
41
56
|
## Available Tools
|
|
42
57
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@graspful/mcp",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "MCP server for Graspful — create adaptive learning courses from AI agents",
|
|
5
5
|
"keywords": ["mcp", "mcp-server", "graspful", "course", "course-creation", "adaptive-learning", "ai-agent", "knowledge-graph", "spaced-repetition", "edtech", "education", "yaml", "lms", "model-context-protocol"],
|
|
6
6
|
"repository": {
|