convez.ai
MCP Server
harmonicabot

harmonica-mcp

harmonicabot/harmonica-mcp

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server for Harmonica deliberation sessions — create, query, and analyze sessions from any AI agent

Instalação

$npx convez-ai harmonicabot/harmonica-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
1
Acompanhando
0
Saúde
50%
Último commit
há 2 dias
Versão
—
Issues abertas
2
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Harmonica MCP Server

npm version

MCP server enabling AI agents to create and query Harmonica deliberation sessions.

Harmonica 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. Learn more.

Quick Start

1. Get an API key

  1. Sign up for Harmonica (free)
  2. Go to Profile > API Keys > Generate API Key
  3. Copy your hm_live_... key — it's only shown once

2. Configure your MCP client

Add to your MCP client config (e.g. Claude Code, Cursor, Windsurf):

{
  "mcpServers": {
    "harmonica": {
      "command": "npx",
      "args": ["-y", "harmonica-mcp"],
      "env": {
        "HARMONICA_API_KEY": "hm_live_your_key_here"
      }
    }
  }
}

3. Start a deliberation

Ask your AI agent to create a session:

Create a Harmonica session about "Team Retrospective" with the goal "Review Q1 and identify improvements"

Share the join URL with participants. Once they've responded, use get_responses and get_summary to see the results.

Tools

ToolDescription
create_sessionCreate a new deliberation session and get a shareable join URL (optional: questions)
update_sessionUpdate session metadata (topic, goal, context, critical, prompt)
list_sessionsList your deliberation sessions (filter by status, search)
get_sessionGet full session details (includes facilitation prompt)
get_questionsGet pre-session questions (data collection form)
get_responsesGet participant responses
get_summaryGet AI-generated summary
search_sessionsSearch by topic or goal
list_telegram_groupsList Telegram groups registered to the user's account (no parameters)
install_method_specInstall an OFL method spec (method.md) as a runnable chain template

From Source

git clone https://github.com/harmonicabot/harmonica-mcp.git
cd harmonica-mcp
npm install && npm run build

Then use node /path/to/harmonica-mcp/dist/index.js instead of npx -y harmonica-mcp in your config.

Environment Variables

VariableRequiredDefaultDescription
HARMONICA_API_KEYYes—Your Harmonica API key
HARMONICA_API_URLNohttps://app.harmonica.chatAPI base URL

Roadmap

  • One-command install via npx add-mcp (auto-detects Claude Code, Cursor, Windsurf)
  • HTTP transport — zero-install setup, just add a URL
  • Inbound context — feed external data into sessions via MCP
  • Session templates discovery tool
  • TypeScript and Python client SDKs

See Also

  • harmonica-chat — Conversational Harmonica companion for Claude Code — design, create, and manage sessions (/harmonica-chat)
  • Harmonica docs — Full platform documentation and API reference

License

MIT

Ver o original no GitHub

Bom para

Relacionados