@tideorg/mcp 1.4.0 → 1.4.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.
Files changed (2) hide show
  1. package/README.md +120 -38
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,38 +1,120 @@
1
- # Tide Agent Pack
2
-
3
- This repo turns Tide source material into operational assets for AI coding agents.
4
-
5
- ## Goal
6
-
7
- Help coding agents implement Tide correctly for low-experience builders.
8
-
9
- ## Primary outputs
10
-
11
- - canon doctrine
12
- - implementation playbooks
13
- - agent adapters
14
- - skills
15
- - starter prompts
16
- - starter templates
17
- - eval cases
18
-
19
- ## Source policy
20
-
21
- Put copied authoritative material in `sources/`.
22
- Do not rely on drifting live docs during drafting.
23
- Mark content as:
24
- - `VERIFIED`
25
- - `INFERRED`
26
- - `ASSUMED`
27
-
28
- ## Drafting order
29
-
30
- 1. `notes/source-audit.md`
31
- 2. `canon/*`
32
- 3. `playbooks/*`
33
- 4. `adapters/*`
34
- 5. `skills/*`
35
- 6. `prompts/*`
36
- 7. `templates/*`
37
- 8. `evals/cases.yaml`
38
- 9. `GAP_REGISTER.md`
1
+ # Tide Agent Pack
2
+
3
+ AI coding agents that know how to implement [TideCloak](https://tidecloak.com) correctly.
4
+
5
+ This MCP server gives your AI assistant deep knowledge of Tide authentication, threshold cryptography, Forseti smart contracts, and server-side security patterns. Instead of guessing, your AI follows verified playbooks.
6
+
7
+ ## Quick Start
8
+
9
+ ### Claude Code (CLI or VS Code extension)
10
+
11
+ Run this one command:
12
+
13
+ ```bash
14
+ claude mcp add tide-pack -- npx -y @tideorg/mcp
15
+ ```
16
+
17
+ Done. Start a conversation and ask your agent to add Tide auth to your app.
18
+
19
+ ### Project-level config (any MCP client)
20
+
21
+ Add a `.mcp.json` file to your project root:
22
+
23
+ ```json
24
+ {
25
+ "mcpServers": {
26
+ "tide-pack": {
27
+ "command": "npx",
28
+ "args": ["-y", "@tideorg/mcp"]
29
+ }
30
+ }
31
+ }
32
+ ```
33
+
34
+ Works with: Claude Code, Cursor, Windsurf, Cline, and any MCP-compatible tool.
35
+
36
+ ### Claude Desktop
37
+
38
+ Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
39
+
40
+ ```json
41
+ {
42
+ "mcpServers": {
43
+ "tide-pack": {
44
+ "command": "npx",
45
+ "args": ["-y", "@tideorg/mcp"]
46
+ }
47
+ }
48
+ }
49
+ ```
50
+
51
+ ### Cursor
52
+
53
+ Open Settings > MCP Servers > Add Server:
54
+ - Name: `tide-pack`
55
+ - Command: `npx`
56
+ - Args: `-y @tideorg/mcp`
57
+
58
+ Or add to `.cursor/mcp.json` in your project root.
59
+
60
+ ### Windsurf
61
+
62
+ Add to `~/.codeium/windsurf/mcp_config.json`:
63
+
64
+ ```json
65
+ {
66
+ "mcpServers": {
67
+ "tide-pack": {
68
+ "command": "npx",
69
+ "args": ["-y", "@tideorg/mcp"]
70
+ }
71
+ }
72
+ }
73
+ ```
74
+
75
+ ## What your AI can do with this
76
+
77
+ Once connected, your AI assistant can:
78
+
79
+ - **Add Tide auth** to a new or existing Next.js/React app
80
+ - **Protect API routes** with server-side JWT + DPoP verification
81
+ - **Set up role-based access** with Tide's IGA governance
82
+ - **Deploy Forseti smart contracts** for policy-governed encryption and signing
83
+ - **Bootstrap TideCloak** from Docker to fully configured realm
84
+ - **Diagnose issues** like broken login, missing roles, CORS errors
85
+ - **Follow security invariants** that prevent common auth mistakes
86
+
87
+ ## Try it
88
+
89
+ After setup, try these prompts in your AI coding tool:
90
+
91
+ > Add Tide authentication to my Next.js app
92
+
93
+ > I have an existing app with auth — help me migrate to Tide
94
+
95
+ > Set up encrypted data sharing between users with Tide
96
+
97
+ > Help me create a Forseti contract for multi-admin approval
98
+
99
+ ## What's inside
100
+
101
+ | Category | Count | Examples |
102
+ |----------|-------|---------|
103
+ | Canon doctrine | 12 files | Security invariants, anti-patterns, framework matrix, troubleshooting |
104
+ | Playbooks | 17 step-by-step guides | Add auth, protect APIs, verify JWTs, deploy TideCloak, set up E2EE |
105
+ | Skills | 9 composable roles | Setup, integration, security review, learning capture |
106
+ | Scenarios | 5 reference architectures | Password manager, signing service, encrypted chat, governance panel |
107
+ | Prompts | 4 starter prompts | Secure existing app, migrate auth, admin approval, customer portal |
108
+
109
+ ## Requirements
110
+
111
+ - Node.js 18+
112
+ - An MCP-compatible AI coding tool
113
+
114
+ No TideCloak instance needed to start — the agent will guide you through setup.
115
+
116
+ ## Links
117
+
118
+ - [TideCloak](https://tidecloak.com) — The identity platform
119
+ - [npm package](https://www.npmjs.com/package/@tideorg/mcp) — `@tideorg/mcp`
120
+ - [Tide Foundation](https://tide.org) — The organisation behind Tide
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tideorg/mcp",
3
- "version": "1.4.0",
3
+ "version": "1.4.1",
4
4
  "description": "MCP server exposing Tide operational guidance — canon, playbooks, skills, prompts, adapters, and scenarios for AI coding agents",
5
5
  "type": "module",
6
6
  "bin": {