harmonica-mcp 0.2.0

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 Harmonica
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# Harmonica MCP Server
+
+MCP server enabling AI agents to create and query [Harmonica](https://harmonica.chat) deliberation sessions.
+
+[Harmonica](https://harmonica.chat) is a structured deliberation platform where groups coordinate through AI-facilitated async conversations. Create a session with a topic and goal, share a link with participants, and each person has a private 1:1 conversation with an AI facilitator. Responses are synthesized into actionable insights.
+
+## Quick Start
+
+### npx (no install)
+
+```json
+{
+  "mcpServers": {
+    "harmonica": {
+      "command": "npx",
+      "args": ["-y", "harmonica-mcp"],
+      "env": {
+        "HARMONICA_API_KEY": "hm_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### From source
+
+```bash
+git clone https://github.com/harmonicabot/harmonica-mcp.git
+cd harmonica-mcp
+npm install && npm run build
+```
+
+```json
+{
+  "mcpServers": {
+    "harmonica": {
+      "command": "node",
+      "args": ["/path/to/harmonica-mcp/dist/index.js"],
+      "env": {
+        "HARMONICA_API_KEY": "hm_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Get an API key
+
+1. [Sign up for Harmonica](https://app.harmonica.chat) (free)
+2. Go to [Profile](https://app.harmonica.chat/profile) > **API Keys** > **Generate API Key**
+3. Copy your `hm_live_...` key — it's only shown once
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_session` | Create a new deliberation session and get a shareable join URL |
+| `list_sessions` | List your deliberation sessions (filter by status, search) |
+| `get_session` | Get full session details |
+| `get_responses` | Get participant responses |
+| `get_summary` | Get AI-generated summary |
+| `search_sessions` | Search by topic or goal |
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `HARMONICA_API_KEY` | Yes | — | Your Harmonica API key |
+| `HARMONICA_API_URL` | No | `https://app.harmonica.chat` | API base URL |
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,99 @@
+/**
+ * HTTP client for the Harmonica REST API v1.
+ * All methods throw on HTTP errors.
+ */
+export interface HarmonicaClientConfig {
+    baseUrl: string;
+    apiKey: string;
+}
+export declare class HarmonicaClient {
+    private baseUrl;
+    private apiKey;
+    constructor(config: HarmonicaClientConfig);
+    private request;
+    getMe(): Promise<{
+        id: string;
+        email: string;
+        name: string | null;
+        subscription_status: string;
+    }>;
+    listSessions(params?: {
+        status?: 'active' | 'completed';
+        q?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        data: Array<{
+            id: string;
+            topic: string;
+            goal: string;
+            status: string;
+            participant_count: number;
+            created_at: string;
+            updated_at: string;
+        }>;
+        pagination: {
+            total: number;
+            limit: number;
+            offset: number;
+        };
+    }>;
+    getSession(id: string): Promise<{
+        id: string;
+        topic: string;
+        goal: string;
+        critical: string | null;
+        context: string | null;
+        status: string;
+        summary: string | null;
+        participant_count: number;
+        created_at: string;
+        updated_at: string;
+    }>;
+    getSessionQuestions(sessionId: string): Promise<{
+        data: Array<{
+            id: string;
+            text: string;
+            position: number;
+        }>;
+    }>;
+    getSessionResponses(sessionId: string): Promise<{
+        data: Array<{
+            participant_name: string | null;
+            messages: Array<{
+                role: "user" | "assistant";
+                content: string;
+                created_at: string;
+            }>;
+        }>;
+    }>;
+    submitResponse(sessionId: string, content: string): Promise<{
+        id: string;
+        session_id: string;
+        content: string;
+        created_at: string;
+    }>;
+    createSession(params: {
+        topic: string;
+        goal: string;
+        context?: string;
+        critical?: string;
+        prompt?: string;
+        template_id?: string;
+        cross_pollination?: boolean;
+    }): Promise<{
+        id: string;
+        topic: string;
+        goal: string;
+        status: string;
+        participant_count: number;
+        created_at: string;
+        updated_at: string;
+        join_url: string;
+    }>;
+    getSessionSummary(sessionId: string): Promise<{
+        session_id: string;
+        summary: string | null;
+        generated_at: string | null;
+    }>;
+}

package/dist/client.js

@@ -0,0 +1,70 @@
+/**
+ * HTTP client for the Harmonica REST API v1.
+ * All methods throw on HTTP errors.
+ */
+export class HarmonicaClient {
+    baseUrl;
+    apiKey;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/+$/, '');
+        this.apiKey = config.apiKey;
+    }
+    async request(path, options) {
+        const url = `${this.baseUrl}/api/v1${path}`;
+        const res = await fetch(url, {
+            ...options,
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+                ...options?.headers,
+            },
+        });
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({}));
+            const message = body?.error?.message || `HTTP ${res.status}`;
+            throw new Error(`Harmonica API error: ${message}`);
+        }
+        return res.json();
+    }
+    async getMe() {
+        return this.request('/me');
+    }
+    async listSessions(params) {
+        const query = new URLSearchParams();
+        if (params?.status)
+            query.set('status', params.status);
+        if (params?.q)
+            query.set('q', params.q);
+        if (params?.limit)
+            query.set('limit', String(params.limit));
+        if (params?.offset)
+            query.set('offset', String(params.offset));
+        const qs = query.toString();
+        return this.request(`/sessions${qs ? `?${qs}` : ''}`);
+    }
+    async getSession(id) {
+        return this.request(`/sessions/${id}`);
+    }
+    async getSessionQuestions(sessionId) {
+        return this.request(`/sessions/${sessionId}/questions`);
+    }
+    async getSessionResponses(sessionId) {
+        return this.request(`/sessions/${sessionId}/responses`);
+    }
+    async submitResponse(sessionId, content) {
+        return this.request(`/sessions/${sessionId}/responses`, {
+            method: 'POST',
+            body: JSON.stringify({ content }),
+        });
+    }
+    async createSession(params) {
+        return this.request('/sessions', {
+            method: 'POST',
+            body: JSON.stringify(params),
+        });
+    }
+    async getSessionSummary(sessionId) {
+        return this.request(`/sessions/${sessionId}/summary`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { HarmonicaClient } from './client.js';
+const HARMONICA_API_URL = process.env.HARMONICA_API_URL || 'https://app.harmonica.chat';
+const HARMONICA_API_KEY = process.env.HARMONICA_API_KEY;
+if (!HARMONICA_API_KEY) {
+    console.error('Error: HARMONICA_API_KEY environment variable is required.');
+    console.error('Generate one at https://app.harmonica.chat (Profile → API Keys)');
+    process.exit(1);
+}
+const client = new HarmonicaClient({
+    baseUrl: HARMONICA_API_URL,
+    apiKey: HARMONICA_API_KEY,
+});
+const server = new McpServer({
+    name: 'harmonica',
+    version: '0.1.0',
+});
+// ─── Tools ───────────────────────────────────────────────────────────
+server.tool('list_sessions', 'List Harmonica deliberation sessions you have access to', {
+    status: z.enum(['active', 'completed']).optional().describe('Filter by status'),
+    query: z.string().optional().describe('Search by topic or goal'),
+    limit: z.number().min(1).max(100).optional().describe('Results per page (default 20)'),
+}, async ({ status, query, limit }) => {
+    const result = await client.listSessions({ status, q: query, limit });
+    const lines = result.data.map((s) => `[${s.status}] ${s.topic} (${s.participant_count} participants) — ${s.id}`);
+    const text = lines.length
+        ? `${result.pagination.total} sessions found:\n\n${lines.join('\n')}`
+        : 'No sessions found.';
+    return { content: [{ type: 'text', text }] };
+});
+server.tool('get_session', 'Get details of a specific Harmonica session', {
+    session_id: z.string().describe('Session ID (UUID)'),
+}, async ({ session_id }) => {
+    const s = await client.getSession(session_id);
+    const text = [
+        `**${s.topic}**`,
+        `Status: ${s.status} | Participants: ${s.participant_count}`,
+        `Goal: ${s.goal}`,
+        s.critical ? `Critical: ${s.critical}` : null,
+        s.context ? `Context: ${s.context}` : null,
+        s.summary ? `\nSummary:\n${s.summary}` : null,
+        `\nCreated: ${s.created_at}`,
+    ]
+        .filter(Boolean)
+        .join('\n');
+    return { content: [{ type: 'text', text }] };
+});
+server.tool('get_responses', 'Get participant responses for a Harmonica session', {
+    session_id: z.string().describe('Session ID (UUID)'),
+}, async ({ session_id }) => {
+    const result = await client.getSessionResponses(session_id);
+    if (!result.data.length) {
+        return { content: [{ type: 'text', text: 'No responses yet.' }] };
+    }
+    const sections = result.data.map((p) => {
+        const name = p.participant_name || 'Anonymous';
+        const msgs = p.messages
+            .filter((m) => m.role === 'user')
+            .map((m) => `  > ${m.content}`)
+            .join('\n');
+        return `**${name}:**\n${msgs || '  (no responses)'}`;
+    });
+    return { content: [{ type: 'text', text: sections.join('\n\n') }] };
+});
+server.tool('get_summary', 'Get the AI-generated summary for a Harmonica session', {
+    session_id: z.string().describe('Session ID (UUID)'),
+}, async ({ session_id }) => {
+    const result = await client.getSessionSummary(session_id);
+    const text = result.summary || 'No summary available yet (session may still be active).';
+    return { content: [{ type: 'text', text }] };
+});
+server.tool('search_sessions', 'Search Harmonica sessions by topic or goal keywords', {
+    query: z.string().describe('Search keywords'),
+    status: z.enum(['active', 'completed']).optional().describe('Filter by status'),
+}, async ({ query, status }) => {
+    const result = await client.listSessions({ q: query, status, limit: 20 });
+    if (!result.data.length) {
+        return { content: [{ type: 'text', text: `No sessions match "${query}".` }] };
+    }
+    const lines = result.data.map((s) => `- [${s.status}] **${s.topic}** — ${s.goal}\n  ID: ${s.id}`);
+    return {
+        content: [{ type: 'text', text: `Found ${result.pagination.total} sessions:\n\n${lines.join('\n')}` }],
+    };
+});
+server.tool('create_session', 'Create a new Harmonica deliberation session and get a shareable join URL', {
+    topic: z.string().describe('Session topic'),
+    goal: z.string().describe('What this session aims to achieve'),
+    context: z.string().optional().describe('Background context for participants'),
+    critical: z.string().optional().describe('Critical question or constraint'),
+    prompt: z.string().optional().describe('Custom facilitation prompt'),
+    template_id: z.string().optional().describe('Template ID to use'),
+    cross_pollination: z.boolean().optional().describe('Enable idea sharing between participant threads'),
+}, async ({ topic, goal, context, critical, prompt, template_id, cross_pollination }) => {
+    const session = await client.createSession({
+        topic,
+        goal,
+        context,
+        critical,
+        prompt,
+        template_id,
+        cross_pollination,
+    });
+    const text = [
+        `Session created!`,
+        ``,
+        `  Topic:    ${session.topic}`,
+        `  ID:       ${session.id}`,
+        `  Status:   ${session.status}`,
+        `  Join URL: ${session.join_url}`,
+        ``,
+        `Share the join URL with participants to start the session.`,
+    ].join('\n');
+    return { content: [{ type: 'text', text }] };
+});
+// ─── Start ───────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "harmonica-mcp",
+  "version": "0.2.0",
+  "description": "MCP server for Harmonica deliberation sessions",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "harmonica-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "mcp",
+    "harmonica",
+    "deliberation",
+    "facilitation",
+    "model-context-protocol"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/harmonicabot/harmonica-mcp.git"
+  },
+  "homepage": "https://github.com/harmonicabot/harmonica-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.5.0"
+  }
+}