@simple-product/mcp 0.1.1 → 0.1.3

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import chalk from "chalk";
 import ora from "ora";
 import open from "open";
@@ -12,7 +12,7 @@ import * as crypto from "crypto";
 // ============================================
 // Configuration
 // ============================================
-const PRODUCTION_URL = "https://simple-product.app";
+const PRODUCTION_URL = "https://simpleproduct.dev";
 const DEV_URL = "http://localhost:3000";
 const CONFIG_DIR = path.join(os.homedir(), ".simple-product");
 const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
@@ -354,8 +354,418 @@ async function runServer() {
     }, {
         capabilities: {
             tools: {},
+            resources: {},
         },
     });
+    // ============================================
+    // Documentation Resources
+    // ============================================
+    const resources = [
+        {
+            uri: "docs://simple-product/feedback-setup",
+            name: "Feedback Collection Setup Guide",
+            description: "Complete guide for implementing customer feedback collection in your app",
+            mimeType: "text/markdown",
+        },
+        {
+            uri: "docs://simple-product/api-reference",
+            name: "API Reference",
+            description: "Full API reference for all Simple Product endpoints",
+            mimeType: "text/markdown",
+        },
+        {
+            uri: "docs://simple-product/people-api",
+            name: "People & Organizations API",
+            description: "Guide for tracking customers and organizations",
+            mimeType: "text/markdown",
+        },
+    ];
+    const resourceContents = {
+        "docs://simple-product/feedback-setup": `# Feedback Collection Setup Guide
+
+Simple Product makes it easy to collect customer feedback from your app.
+
+## Quick Start Options
+
+### Option 1: HTML Form (Simplest)
+
+Add this form anywhere in your app. No JavaScript required:
+
+\`\`\`html
+<form action="${baseUrl}/api/v1/feedback?key=YOUR_API_KEY&redirect=https://yoursite.com/thanks" method="POST">
+  <input type="hidden" name="title" value="Feedback" />
+  <input name="email" placeholder="Email (optional)" />
+  <input name="name" placeholder="Name (optional)" />
+  <textarea name="content" placeholder="Your feedback..." required></textarea>
+  <button type="submit">Send Feedback</button>
+</form>
+\`\`\`
+
+After submission, users are redirected to your URL with \`?success=true\` or \`?error=message\`.
+
+### Option 2: JavaScript/Fetch
+
+\`\`\`javascript
+async function submitFeedback(feedback) {
+  const response = await fetch('${baseUrl}/api/v1/feedback', {
+    method: 'POST',
+    headers: {
+      'Authorization': 'Bearer YOUR_API_KEY',
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      title: feedback.title || 'Feedback',
+      content: feedback.content,
+      email: feedback.email,      // Optional: links to customer record
+      name: feedback.name,        // Optional
+      source: 'web-widget',       // Optional: track where feedback came from
+      metadata: {                 // Optional: any custom data
+        page: window.location.pathname,
+        userAgent: navigator.userAgent,
+      }
+    }),
+  });
+  return response.json();
+}
+\`\`\`
+
+### Option 3: React Component
+
+\`\`\`tsx
+import { useState } from 'react';
+
+function FeedbackWidget({ apiKey }: { apiKey: string }) {
+  const [content, setContent] = useState('');
+  const [email, setEmail] = useState('');
+  const [status, setStatus] = useState<'idle' | 'sending' | 'sent' | 'error'>('idle');
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setStatus('sending');
+
+    try {
+      const res = await fetch('${baseUrl}/api/v1/feedback', {
+        method: 'POST',
+        headers: {
+          'Authorization': \`Bearer \${apiKey}\`,
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+          title: 'Feedback',
+          content,
+          email: email || undefined,
+          source: 'react-widget',
+        }),
+      });
+
+      if (res.ok) {
+        setStatus('sent');
+        setContent('');
+        setEmail('');
+      } else {
+        setStatus('error');
+      }
+    } catch {
+      setStatus('error');
+    }
+  };
+
+  if (status === 'sent') {
+    return <div>Thanks for your feedback!</div>;
+  }
+
+  return (
+    <form onSubmit={handleSubmit}>
+      <input
+        type="email"
+        placeholder="Email (optional)"
+        value={email}
+        onChange={(e) => setEmail(e.target.value)}
+      />
+      <textarea
+        placeholder="Your feedback..."
+        value={content}
+        onChange={(e) => setContent(e.target.value)}
+        required
+      />
+      <button type="submit" disabled={status === 'sending'}>
+        {status === 'sending' ? 'Sending...' : 'Send Feedback'}
+      </button>
+      {status === 'error' && <p>Something went wrong. Please try again.</p>}
+    </form>
+  );
+}
+\`\`\`
+
+## API Reference
+
+### POST /api/v1/feedback
+
+**Headers:**
+- \`Authorization: Bearer YOUR_API_KEY\` (required for JSON requests)
+- \`Content-Type: application/json\`
+
+**Body:**
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| title | string | Yes | Feedback title/subject |
+| content | string | Yes | The feedback message |
+| email | string | No | Customer email (creates/links customer record) |
+| name | string | No | Customer name |
+| externalId | string | No | Your user ID for identity matching |
+| source | string | No | Where feedback came from (e.g., "widget", "nps") |
+| metadata | object | No | Any custom JSON data |
+
+**Response:**
+\`\`\`json
+{
+  "data": {
+    "id": "abc123",
+    "title": "Feedback",
+    "content": "...",
+    "person": { "id": "...", "name": "John", "email": "john@example.com" },
+    "createdAt": 1234567890
+  }
+}
+\`\`\`
+
+## Getting Your API Key
+
+1. Go to Settings → API Keys in your Simple Product workspace
+2. Create a new API key
+3. Copy the key and store it securely (it won't be shown again)
+
+## Tips
+
+- **Link feedback to customers**: Include \`email\` to automatically create/link customer records
+- **Track sources**: Use the \`source\` field to see where feedback comes from
+- **Add context**: Use \`metadata\` to include page URL, user agent, feature flags, etc.
+`,
+        "docs://simple-product/api-reference": `# Simple Product API Reference
+
+Base URL: \`${baseUrl}/api/v1\`
+
+## Authentication
+
+All API requests require authentication via API key:
+
+\`\`\`
+Authorization: Bearer YOUR_API_KEY
+\`\`\`
+
+Get your API key from Settings → API Keys in your workspace.
+
+## Endpoints
+
+### Feedback
+
+#### POST /api/v1/feedback
+Submit customer feedback.
+
+**Body:**
+\`\`\`json
+{
+  "title": "Feature request",
+  "content": "I would love to see...",
+  "email": "customer@example.com",
+  "name": "John Doe",
+  "source": "widget",
+  "metadata": { "page": "/settings" }
+}
+\`\`\`
+
+### People (Customers)
+
+#### POST /api/v1/people
+Create or update a customer record.
+
+**Body:**
+\`\`\`json
+{
+  "email": "customer@example.com",
+  "name": "John Doe",
+  "externalId": "user_123",
+  "properties": {
+    "plan": "pro",
+    "company": "Acme Inc"
+  }
+}
+\`\`\`
+
+#### GET /api/v1/people?email=customer@example.com
+Look up a customer by email.
+
+#### GET /api/v1/people/:id
+Get a customer by ID.
+
+### Organizations
+
+#### POST /api/v1/organizations
+Create or update an organization.
+
+**Body:**
+\`\`\`json
+{
+  "name": "Acme Inc",
+  "domain": "acme.com",
+  "properties": {
+    "plan": "enterprise",
+    "seats": 50
+  }
+}
+\`\`\`
+
+### Releases (Changelog)
+
+#### GET /api/v1/releases/public?workspace=YOUR_WORKSPACE_SLUG
+Get published releases (public, no auth required).
+
+#### POST /api/v1/releases
+Create a new release.
+
+**Body:**
+\`\`\`json
+{
+  "title": "v2.1.0",
+  "content": "## What's New\\n- Dark mode\\n- Bug fixes",
+  "status": "published",
+  "publishedAt": 1234567890
+}
+\`\`\`
+
+## Error Responses
+
+All errors return:
+\`\`\`json
+{
+  "error": "Error message here"
+}
+\`\`\`
+
+Common status codes:
+- 400: Bad request (missing/invalid fields)
+- 401: Unauthorized (missing/invalid API key)
+- 404: Not found
+- 429: Rate limited
+- 500: Server error
+`,
+        "docs://simple-product/people-api": `# People & Organizations API
+
+Track your customers and their organizations in Simple Product.
+
+## Identifying Customers
+
+Simple Product uses these fields to identify customers (in order of priority):
+
+1. **externalId** - Your internal user ID (most reliable)
+2. **email** - Customer's email address
+
+When you submit feedback or call the People API with these identifiers, Simple Product will:
+- Create a new customer record if none exists
+- Update the existing record if found
+- Link feedback to the customer
+
+## JavaScript SDK Pattern
+
+\`\`\`javascript
+class SimpleProduct {
+  constructor(apiKey) {
+    this.apiKey = apiKey;
+    this.baseUrl = '${baseUrl}/api/v1';
+  }
+
+  async identify(user) {
+    // Call this when a user logs in or updates their profile
+    return fetch(\`\${this.baseUrl}/people\`, {
+      method: 'POST',
+      headers: {
+        'Authorization': \`Bearer \${this.apiKey}\`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        externalId: user.id,
+        email: user.email,
+        name: user.name,
+        properties: {
+          plan: user.plan,
+          createdAt: user.createdAt,
+          // Add any custom properties
+        },
+      }),
+    });
+  }
+
+  async feedback(content, options = {}) {
+    return fetch(\`\${this.baseUrl}/feedback\`, {
+      method: 'POST',
+      headers: {
+        'Authorization': \`Bearer \${this.apiKey}\`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        title: options.title || 'Feedback',
+        content,
+        externalId: options.userId,
+        email: options.email,
+        source: options.source || 'sdk',
+        metadata: options.metadata,
+      }),
+    });
+  }
+}
+
+// Usage
+const sp = new SimpleProduct('your_api_key');
+
+// When user logs in
+await sp.identify({
+  id: 'user_123',
+  email: 'john@example.com',
+  name: 'John Doe',
+  plan: 'pro',
+});
+
+// When user submits feedback
+await sp.feedback('Love the new feature!', {
+  userId: 'user_123',
+  source: 'feedback-modal',
+});
+\`\`\`
+
+## Organizations
+
+Link customers to organizations for B2B use cases:
+
+\`\`\`javascript
+// Create/update organization
+await fetch('${baseUrl}/api/v1/organizations', {
+  method: 'POST',
+  headers: {
+    'Authorization': 'Bearer YOUR_API_KEY',
+    'Content-Type': 'application/json',
+  },
+  body: JSON.stringify({
+    name: 'Acme Inc',
+    domain: 'acme.com',
+    properties: {
+      plan: 'enterprise',
+      seats: 50,
+      industry: 'Technology',
+    },
+  }),
+});
+\`\`\`
+
+Organizations are automatically linked to people based on email domain.
+
+## Best Practices
+
+1. **Always include externalId** - Email can change, your user ID won't
+2. **Call identify on login** - Keep customer data fresh
+3. **Use properties for segmentation** - Plan, role, company size, etc.
+4. **Track source on feedback** - Know where feedback comes from
+`,
+    };
     // Define tools
     const tools = [
         {
@@ -551,14 +961,1017 @@ async function runServer() {
                 required: ["query"],
             },
         },
+        // Linking tools - Doc-Card
+        {
+            name: "link_doc_to_card",
+            description: "Link a document to a card. Useful for associating specs, notes, or documentation with a task or feature.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    docId: { type: "string", description: "The ID of the document to link" },
+                    cardId: { type: "string", description: "The ID of the card to link the document to" },
+                },
+                required: ["docId", "cardId"],
+            },
+        },
+        {
+            name: "unlink_doc_from_card",
+            description: "Remove the link between a document and a card",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    docId: { type: "string", description: "The ID of the document to unlink" },
+                    cardId: { type: "string", description: "The ID of the card to unlink from" },
+                },
+                required: ["docId", "cardId"],
+            },
+        },
+        {
+            name: "get_docs_for_card",
+            description: "Get all documents linked to a card",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    cardId: { type: "string", description: "The ID of the card" },
+                },
+                required: ["cardId"],
+            },
+        },
+        {
+            name: "get_cards_for_doc",
+            description: "Get all cards linked to a document",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    docId: { type: "string", description: "The ID of the document" },
+                },
+                required: ["docId"],
+            },
+        },
+        // Linking tools - Doc-Person
+        {
+            name: "link_doc_to_person",
+            description: "Link a document to a person. Useful for associating meeting notes or feedback with a customer.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    docId: { type: "string", description: "The ID of the document to link" },
+                    personId: { type: "string", description: "The ID of the person to link the document to" },
+                },
+                required: ["docId", "personId"],
+            },
+        },
+        {
+            name: "unlink_doc_from_person",
+            description: "Remove the link between a document and a person",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    docId: { type: "string", description: "The ID of the document to unlink" },
+                    personId: { type: "string", description: "The ID of the person to unlink from" },
+                },
+                required: ["docId", "personId"],
+            },
+        },
+        {
+            name: "get_docs_for_person",
+            description: "Get all documents linked to a person",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    personId: { type: "string", description: "The ID of the person" },
+                },
+                required: ["personId"],
+            },
+        },
+        {
+            name: "get_people_for_doc",
+            description: "Get all people linked to a document",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    docId: { type: "string", description: "The ID of the document" },
+                },
+                required: ["docId"],
+            },
+        },
+        // Linking tools - Card-Person
+        {
+            name: "link_card_to_person",
+            description: "Link a card to a person. Useful for tracking which customers requested a feature.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    cardId: { type: "string", description: "The ID of the card to link" },
+                    personId: { type: "string", description: "The ID of the person to link the card to" },
+                },
+                required: ["cardId", "personId"],
+            },
+        },
+        {
+            name: "unlink_card_from_person",
+            description: "Remove the link between a card and a person",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    cardId: { type: "string", description: "The ID of the card to unlink" },
+                    personId: { type: "string", description: "The ID of the person to unlink from" },
+                },
+                required: ["cardId", "personId"],
+            },
+        },
+        {
+            name: "get_cards_for_person",
+            description: "Get all cards linked to a person",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    personId: { type: "string", description: "The ID of the person" },
+                },
+                required: ["personId"],
+            },
+        },
+        {
+            name: "get_people_for_card",
+            description: "Get all people linked to a card",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    cardId: { type: "string", description: "The ID of the card" },
+                },
+                required: ["cardId"],
+            },
+        },
+        {
+            name: "get_setup_guide",
+            description: "Get implementation guide for integrating Simple Product features into your app. Returns code examples and instructions tailored to your framework.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    feature: {
+                        type: "string",
+                        enum: ["feedback", "people", "releases", "all"],
+                        description: "Which feature to get setup instructions for",
+                    },
+                    framework: {
+                        type: "string",
+                        enum: ["react", "nextjs", "vue", "html", "node", "python"],
+                        description: "Target framework for code examples (default: react)",
+                    },
+                },
+                required: ["feature"],
+            },
+        },
+        // Release tools
+        {
+            name: "create_release",
+            description: "Create a new release/changelog entry. Use this to document new features, bug fixes, or updates.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    title: { type: "string", description: "The title of the release (e.g., 'v1.2.0 - New Dashboard Features')" },
+                    content: { type: "string", description: "The release notes content in markdown format" },
+                },
+                required: ["title"],
+            },
+        },
+        {
+            name: "update_release",
+            description: "Update an existing release's title or content",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    releaseId: { type: "string", description: "The ID of the release to update" },
+                    title: { type: "string", description: "New title for the release" },
+                    content: { type: "string", description: "New release notes content" },
+                },
+                required: ["releaseId"],
+            },
+        },
+        {
+            name: "get_release",
+            description: "Get a release's full content by ID",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    releaseId: { type: "string", description: "The ID of the release to retrieve" },
+                },
+                required: ["releaseId"],
+            },
+        },
+        {
+            name: "search_releases",
+            description: "Search for releases by title or content",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: { type: "string", description: "Search query" },
+                },
+                required: ["query"],
+            },
+        },
+        {
+            name: "list_releases",
+            description: "List all releases in the workspace, sorted by date (newest first)",
+            inputSchema: {
+                type: "object",
+                properties: {},
+            },
+        },
+        // Feedback tools
+        {
+            name: "create_feedback",
+            description: "Create a new feedback entry. Use this to capture user feedback, feature requests, or bug reports.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    title: { type: "string", description: "The title/summary of the feedback" },
+                    content: { type: "string", description: "The detailed feedback content in markdown format" },
+                    personId: { type: "string", description: "Optional ID of the person who provided this feedback" },
+                },
+                required: ["title"],
+            },
+        },
+        {
+            name: "update_feedback",
+            description: "Update an existing feedback entry's title or content",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    feedbackId: { type: "string", description: "The ID of the feedback to update" },
+                    title: { type: "string", description: "New title for the feedback" },
+                    content: { type: "string", description: "New content for the feedback" },
+                },
+                required: ["feedbackId"],
+            },
+        },
+        {
+            name: "get_feedback",
+            description: "Get a feedback entry's full content by ID, including the linked person if any",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    feedbackId: { type: "string", description: "The ID of the feedback to retrieve" },
+                },
+                required: ["feedbackId"],
+            },
+        },
+        {
+            name: "search_feedback",
+            description: "Search for feedback by title or content",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: { type: "string", description: "Search query" },
+                },
+                required: ["query"],
+            },
+        },
+        {
+            name: "list_feedback",
+            description: "List all feedback in the workspace, sorted by date (newest first)",
+            inputSchema: {
+                type: "object",
+                properties: {},
+            },
+        },
     ];
+    // Handle list resources
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return { resources };
+    });
+    // Handle read resource
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        const content = resourceContents[uri];
+        if (!content) {
+            throw new Error(`Resource not found: ${uri}`);
+        }
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: "text/markdown",
+                    text: content,
+                },
+            ],
+        };
+    });
     // Handle list tools
     server.setRequestHandler(ListToolsRequestSchema, async () => {
         return { tools };
     });
+    // Setup guide content generator
+    const generateSetupGuide = (feature, framework = "react") => {
+        const guides = {
+            feedback: {
+                react: `# Feedback Collection - React Setup
+
+## Quick Implementation
+
+Add this component to your app to collect customer feedback:
+
+\`\`\`tsx
+import { useState } from 'react';
+
+interface FeedbackWidgetProps {
+  apiKey: string;
+  userEmail?: string;
+  userName?: string;
+}
+
+export function FeedbackWidget({ apiKey, userEmail, userName }: FeedbackWidgetProps) {
+  const [isOpen, setIsOpen] = useState(false);
+  const [content, setContent] = useState('');
+  const [status, setStatus] = useState<'idle' | 'sending' | 'sent' | 'error'>('idle');
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setStatus('sending');
+
+    try {
+      const res = await fetch('${baseUrl}/api/v1/feedback', {
+        method: 'POST',
+        headers: {
+          'Authorization': \`Bearer \${apiKey}\`,
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+          title: 'Feedback',
+          content,
+          email: userEmail,
+          name: userName,
+          source: 'react-widget',
+          metadata: { page: window.location.pathname },
+        }),
+      });
+
+      if (res.ok) {
+        setStatus('sent');
+        setTimeout(() => {
+          setIsOpen(false);
+          setStatus('idle');
+          setContent('');
+        }, 2000);
+      } else {
+        setStatus('error');
+      }
+    } catch {
+      setStatus('error');
+    }
+  };
+
+  if (!isOpen) {
+    return (
+      <button
+        onClick={() => setIsOpen(true)}
+        style={{
+          position: 'fixed',
+          bottom: '20px',
+          right: '20px',
+          padding: '12px 24px',
+          borderRadius: '8px',
+          border: 'none',
+          background: '#000',
+          color: '#fff',
+          cursor: 'pointer',
+        }}
+      >
+        Feedback
+      </button>
+    );
+  }
+
+  return (
+    <div style={{
+      position: 'fixed',
+      bottom: '20px',
+      right: '20px',
+      width: '320px',
+      padding: '20px',
+      borderRadius: '12px',
+      background: '#fff',
+      boxShadow: '0 4px 20px rgba(0,0,0,0.15)',
+    }}>
+      <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: '16px' }}>
+        <h3 style={{ margin: 0 }}>Send Feedback</h3>
+        <button onClick={() => setIsOpen(false)} style={{ background: 'none', border: 'none', cursor: 'pointer' }}>✕</button>
+      </div>
+
+      {status === 'sent' ? (
+        <p>Thanks for your feedback!</p>
+      ) : (
+        <form onSubmit={handleSubmit}>
+          <textarea
+            value={content}
+            onChange={(e) => setContent(e.target.value)}
+            placeholder="What's on your mind?"
+            required
+            style={{ width: '100%', minHeight: '100px', marginBottom: '12px', padding: '8px', borderRadius: '6px', border: '1px solid #ddd' }}
+          />
+          <button
+            type="submit"
+            disabled={status === 'sending'}
+            style={{ width: '100%', padding: '10px', borderRadius: '6px', border: 'none', background: '#000', color: '#fff', cursor: 'pointer' }}
+          >
+            {status === 'sending' ? 'Sending...' : 'Send'}
+          </button>
+          {status === 'error' && <p style={{ color: 'red', marginTop: '8px' }}>Something went wrong. Please try again.</p>}
+        </form>
+      )}
+    </div>
+  );
+}
+\`\`\`
+
+## Usage
+
+\`\`\`tsx
+// In your app layout or main component
+import { FeedbackWidget } from './FeedbackWidget';
+
+function App() {
+  return (
+    <>
+      {/* Your app content */}
+      <FeedbackWidget
+        apiKey="YOUR_API_KEY"
+        userEmail={currentUser?.email}
+        userName={currentUser?.name}
+      />
+    </>
+  );
+}
+\`\`\`
+
+## Get Your API Key
+
+1. Go to Settings → API Keys in Simple Product
+2. Create a new API key
+3. Replace YOUR_API_KEY with your actual key
+`,
+                nextjs: `# Feedback Collection - Next.js Setup
+
+## Server Action Approach (Recommended)
+
+### 1. Create a Server Action
+
+\`\`\`typescript
+// app/actions/feedback.ts
+'use server';
+
+export async function submitFeedback(formData: FormData) {
+  const content = formData.get('content') as string;
+  const email = formData.get('email') as string;
+
+  const response = await fetch('${baseUrl}/api/v1/feedback', {
+    method: 'POST',
+    headers: {
+      'Authorization': \`Bearer \${process.env.SIMPLE_PRODUCT_API_KEY}\`,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      title: 'Feedback',
+      content,
+      email: email || undefined,
+      source: 'nextjs-app',
+    }),
+  });
+
+  if (!response.ok) {
+    throw new Error('Failed to submit feedback');
+  }
+
+  return { success: true };
+}
+\`\`\`
+
+### 2. Create a Feedback Form Component
+
+\`\`\`tsx
+// components/feedback-form.tsx
+'use client';
+
+import { useActionState } from 'react';
+import { submitFeedback } from '@/app/actions/feedback';
+
+export function FeedbackForm() {
+  const [state, formAction, isPending] = useActionState(submitFeedback, null);
+
+  return (
+    <form action={formAction}>
+      <textarea name="content" placeholder="Your feedback..." required />
+      <input type="email" name="email" placeholder="Email (optional)" />
+      <button type="submit" disabled={isPending}>
+        {isPending ? 'Sending...' : 'Send Feedback'}
+      </button>
+      {state?.success && <p>Thanks for your feedback!</p>}
+    </form>
+  );
+}
+\`\`\`
+
+### 3. Add Environment Variable
+
+\`\`\`bash
+# .env.local
+SIMPLE_PRODUCT_API_KEY=your_api_key_here
+\`\`\`
+`,
+                html: `# Feedback Collection - HTML Form
+
+The simplest way to collect feedback - no JavaScript required:
+
+\`\`\`html
+<form
+  action="${baseUrl}/api/v1/feedback?key=YOUR_API_KEY&redirect=https://yoursite.com/thanks"
+  method="POST"
+  style="max-width: 400px; margin: 0 auto;"
+>
+  <input type="hidden" name="title" value="Feedback" />
+
+  <div style="margin-bottom: 12px;">
+    <input
+      type="email"
+      name="email"
+      placeholder="Email (optional)"
+      style="width: 100%; padding: 10px; border: 1px solid #ddd; border-radius: 6px;"
+    />
+  </div>
+
+  <div style="margin-bottom: 12px;">
+    <input
+      type="text"
+      name="name"
+      placeholder="Name (optional)"
+      style="width: 100%; padding: 10px; border: 1px solid #ddd; border-radius: 6px;"
+    />
+  </div>
+
+  <div style="margin-bottom: 12px;">
+    <textarea
+      name="content"
+      placeholder="Your feedback..."
+      required
+      style="width: 100%; min-height: 100px; padding: 10px; border: 1px solid #ddd; border-radius: 6px;"
+    ></textarea>
+  </div>
+
+  <button
+    type="submit"
+    style="width: 100%; padding: 12px; background: #000; color: #fff; border: none; border-radius: 6px; cursor: pointer;"
+  >
+    Send Feedback
+  </button>
+</form>
+\`\`\`
+
+After submission, users are redirected to your URL with \`?success=true\` or \`?error=message\`.
+`,
+                node: `# Feedback Collection - Node.js/Express
+
+## API Integration
+
+\`\`\`javascript
+// feedback.js
+const SIMPLE_PRODUCT_API_KEY = process.env.SIMPLE_PRODUCT_API_KEY;
+const SIMPLE_PRODUCT_URL = '${baseUrl}';
+
+async function submitFeedback({ title, content, email, name, source, metadata }) {
+  const response = await fetch(\`\${SIMPLE_PRODUCT_URL}/api/v1/feedback\`, {
+    method: 'POST',
+    headers: {
+      'Authorization': \`Bearer \${SIMPLE_PRODUCT_API_KEY}\`,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      title: title || 'Feedback',
+      content,
+      email,
+      name,
+      source: source || 'api',
+      metadata,
+    }),
+  });
+
+  if (!response.ok) {
+    const error = await response.json();
+    throw new Error(error.error || 'Failed to submit feedback');
+  }
+
+  return response.json();
+}
+
+module.exports = { submitFeedback };
+\`\`\`
+
+## Express Route Example
+
+\`\`\`javascript
+const express = require('express');
+const { submitFeedback } = require('./feedback');
+
+const app = express();
+app.use(express.json());
+
+app.post('/api/feedback', async (req, res) => {
+  try {
+    const { content, email, name } = req.body;
+    const result = await submitFeedback({
+      content,
+      email,
+      name,
+      source: 'express-api',
+    });
+    res.json(result);
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+});
+\`\`\`
+`,
+                python: `# Feedback Collection - Python
+
+## Using requests library
+
+\`\`\`python
+import os
+import requests
+
+SIMPLE_PRODUCT_API_KEY = os.environ.get('SIMPLE_PRODUCT_API_KEY')
+SIMPLE_PRODUCT_URL = '${baseUrl}'
+
+def submit_feedback(content, title='Feedback', email=None, name=None, source='python-sdk', metadata=None):
+    """Submit feedback to Simple Product."""
+    response = requests.post(
+        f'{SIMPLE_PRODUCT_URL}/api/v1/feedback',
+        headers={
+            'Authorization': f'Bearer {SIMPLE_PRODUCT_API_KEY}',
+            'Content-Type': 'application/json',
+        },
+        json={
+            'title': title,
+            'content': content,
+            'email': email,
+            'name': name,
+            'source': source,
+            'metadata': metadata or {},
+        }
+    )
+    response.raise_for_status()
+    return response.json()
+
+# Usage
+result = submit_feedback(
+    content='Great product!',
+    email='user@example.com',
+    name='John Doe'
+)
+print(result)
+\`\`\`
+
+## Flask Example
+
+\`\`\`python
+from flask import Flask, request, jsonify
+
+app = Flask(__name__)
+
+@app.route('/feedback', methods=['POST'])
+def feedback():
+    data = request.json
+    result = submit_feedback(
+        content=data['content'],
+        email=data.get('email'),
+        name=data.get('name'),
+        source='flask-api'
+    )
+    return jsonify(result)
+\`\`\`
+`,
+                vue: `# Feedback Collection - Vue.js Setup
+
+## Composable
+
+\`\`\`typescript
+// composables/useFeedback.ts
+import { ref } from 'vue';
+
+export function useFeedback(apiKey: string) {
+  const isSubmitting = ref(false);
+  const isSuccess = ref(false);
+  const error = ref<string | null>(null);
+
+  async function submitFeedback(content: string, options?: {
+    email?: string;
+    name?: string;
+    source?: string;
+  }) {
+    isSubmitting.value = true;
+    error.value = null;
+
+    try {
+      const res = await fetch('${baseUrl}/api/v1/feedback', {
+        method: 'POST',
+        headers: {
+          'Authorization': \`Bearer \${apiKey}\`,
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+          title: 'Feedback',
+          content,
+          ...options,
+          source: options?.source || 'vue-widget',
+        }),
+      });
+
+      if (!res.ok) throw new Error('Failed to submit');
+
+      isSuccess.value = true;
+      return await res.json();
+    } catch (e) {
+      error.value = e instanceof Error ? e.message : 'Unknown error';
+      throw e;
+    } finally {
+      isSubmitting.value = false;
+    }
+  }
+
+  return { submitFeedback, isSubmitting, isSuccess, error };
+}
+\`\`\`
+
+## Component
+
+\`\`\`vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { useFeedback } from '@/composables/useFeedback';
+
+const { submitFeedback, isSubmitting, isSuccess, error } = useFeedback('YOUR_API_KEY');
+const content = ref('');
+
+async function handleSubmit() {
+  await submitFeedback(content.value);
+  content.value = '';
+}
+</script>
+
+<template>
+  <form @submit.prevent="handleSubmit">
+    <textarea v-model="content" placeholder="Your feedback..." required />
+    <button type="submit" :disabled="isSubmitting">
+      {{ isSubmitting ? 'Sending...' : 'Send Feedback' }}
+    </button>
+    <p v-if="isSuccess">Thanks for your feedback!</p>
+    <p v-if="error" class="error">{{ error }}</p>
+  </form>
+</template>
+\`\`\`
+`,
+            },
+            people: {
+                react: resourceContents["docs://simple-product/people-api"],
+                nextjs: resourceContents["docs://simple-product/people-api"],
+                vue: resourceContents["docs://simple-product/people-api"],
+                html: resourceContents["docs://simple-product/people-api"],
+                node: resourceContents["docs://simple-product/people-api"],
+                python: resourceContents["docs://simple-product/people-api"],
+            },
+            releases: {
+                react: `# Releases API - Display Changelog in Your App
+
+## Fetch Published Releases
+
+\`\`\`typescript
+// hooks/useReleases.ts
+import { useState, useEffect } from 'react';
+
+interface Release {
+  id: string;
+  title: string;
+  content: string;
+  publishedAt: number;
+}
+
+export function useReleases(workspaceSlug: string) {
+  const [releases, setReleases] = useState<Release[]>([]);
+  const [isLoading, setIsLoading] = useState(true);
+
+  useEffect(() => {
+    fetch(\`${baseUrl}/api/v1/releases/public?workspace=\${workspaceSlug}\`)
+      .then(res => res.json())
+      .then(data => {
+        setReleases(data.data || []);
+        setIsLoading(false);
+      });
+  }, [workspaceSlug]);
+
+  return { releases, isLoading };
+}
+\`\`\`
+
+## Changelog Component
+
+\`\`\`tsx
+import { useReleases } from '@/hooks/useReleases';
+
+export function Changelog({ workspaceSlug }: { workspaceSlug: string }) {
+  const { releases, isLoading } = useReleases(workspaceSlug);
+
+  if (isLoading) return <p>Loading...</p>;
+
+  return (
+    <div>
+      <h2>What's New</h2>
+      {releases.map(release => (
+        <article key={release.id}>
+          <h3>{release.title}</h3>
+          <time>{new Date(release.publishedAt).toLocaleDateString()}</time>
+          <div dangerouslySetInnerHTML={{ __html: release.content }} />
+        </article>
+      ))}
+    </div>
+  );
+}
+\`\`\`
+
+## RSS Feed
+
+Subscribe to releases via RSS:
+\`\`\`
+${baseUrl}/api/v1/releases/rss?workspace=YOUR_WORKSPACE_SLUG
+\`\`\`
+`,
+                nextjs: `# Releases API - Next.js Integration
+
+## Server Component
+
+\`\`\`tsx
+// app/changelog/page.tsx
+async function getReleases(workspaceSlug: string) {
+  const res = await fetch(
+    \`${baseUrl}/api/v1/releases/public?workspace=\${workspaceSlug}\`,
+    { next: { revalidate: 3600 } } // Cache for 1 hour
+  );
+  return res.json();
+}
+
+export default async function ChangelogPage() {
+  const { data: releases } = await getReleases('your-workspace-slug');
+
+  return (
+    <main>
+      <h1>Changelog</h1>
+      {releases.map((release: any) => (
+        <article key={release.id}>
+          <h2>{release.title}</h2>
+          <time>{new Date(release.publishedAt).toLocaleDateString()}</time>
+          <div dangerouslySetInnerHTML={{ __html: release.content }} />
+        </article>
+      ))}
+    </main>
+  );
+}
+\`\`\`
+`,
+                html: `# Releases - Embed Changelog
+
+\`\`\`html
+<div id="changelog"></div>
+
+<script>
+  fetch('${baseUrl}/api/v1/releases/public?workspace=YOUR_WORKSPACE_SLUG')
+    .then(res => res.json())
+    .then(({ data }) => {
+      const container = document.getElementById('changelog');
+      container.innerHTML = data.map(release => \`
+        <article>
+          <h3>\${release.title}</h3>
+          <time>\${new Date(release.publishedAt).toLocaleDateString()}</time>
+          <div>\${release.content}</div>
+        </article>
+      \`).join('');
+    });
+</script>
+\`\`\`
+`,
+                vue: `# Releases - Vue.js Integration
+
+\`\`\`vue
+<script setup lang="ts">
+import { ref, onMounted } from 'vue';
+
+const releases = ref([]);
+const workspaceSlug = 'your-workspace-slug';
+
+onMounted(async () => {
+  const res = await fetch(\`${baseUrl}/api/v1/releases/public?workspace=\${workspaceSlug}\`);
+  const { data } = await res.json();
+  releases.value = data;
+});
+</script>
+
+<template>
+  <div>
+    <h2>What's New</h2>
+    <article v-for="release in releases" :key="release.id">
+      <h3>{{ release.title }}</h3>
+      <time>{{ new Date(release.publishedAt).toLocaleDateString() }}</time>
+      <div v-html="release.content" />
+    </article>
+  </div>
+</template>
+\`\`\`
+`,
+                node: `# Releases API - Node.js
+
+\`\`\`javascript
+async function getPublishedReleases(workspaceSlug) {
+  const response = await fetch(
+    \`${baseUrl}/api/v1/releases/public?workspace=\${workspaceSlug}\`
+  );
+  const { data } = await response.json();
+  return data;
+}
+
+// Create a release (authenticated)
+async function createRelease({ title, content, status = 'draft' }) {
+  const response = await fetch('${baseUrl}/api/v1/releases', {
+    method: 'POST',
+    headers: {
+      'Authorization': \`Bearer \${process.env.SIMPLE_PRODUCT_API_KEY}\`,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      title,
+      content,
+      status,
+      publishedAt: status === 'published' ? Date.now() : undefined,
+    }),
+  });
+  return response.json();
+}
+\`\`\`
+`,
+                python: `# Releases API - Python
+
+\`\`\`python
+import requests
+
+def get_published_releases(workspace_slug):
+    """Get all published releases (public, no auth required)."""
+    response = requests.get(
+        f'${baseUrl}/api/v1/releases/public',
+        params={'workspace': workspace_slug}
+    )
+    return response.json()['data']
+
+def create_release(title, content, status='draft'):
+    """Create a new release (requires API key)."""
+    response = requests.post(
+        '${baseUrl}/api/v1/releases',
+        headers={
+            'Authorization': f'Bearer {os.environ["SIMPLE_PRODUCT_API_KEY"]}',
+            'Content-Type': 'application/json',
+        },
+        json={
+            'title': title,
+            'content': content,
+            'status': status,
+            'publishedAt': int(time.time() * 1000) if status == 'published' else None,
+        }
+    )
+    return response.json()
+\`\`\`
+`,
+            },
+            all: {
+                react: `${resourceContents["docs://simple-product/api-reference"]}`,
+                nextjs: `${resourceContents["docs://simple-product/api-reference"]}`,
+                vue: `${resourceContents["docs://simple-product/api-reference"]}`,
+                html: `${resourceContents["docs://simple-product/api-reference"]}`,
+                node: `${resourceContents["docs://simple-product/api-reference"]}`,
+                python: `${resourceContents["docs://simple-product/api-reference"]}`,
+            },
+        };
+        const featureGuide = guides[feature];
+        if (!featureGuide) {
+            return `Unknown feature: ${feature}. Available features: feedback, people, releases, all`;
+        }
+        return featureGuide[framework] || featureGuide.react || `No guide available for ${framework}`;
+    };
     // Handle tool calls
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
+        // Handle get_setup_guide locally
+        if (name === "get_setup_guide") {
+            const { feature, framework } = args;
+            const guide = generateSetupGuide(feature, framework || "react");
+            return {
+                content: [{ type: "text", text: guide }],
+            };
+        }
         try {
             // Call the API endpoint
             const response = await fetch(`${baseUrl}/api/mcp/execute`, {