@boxverse_ai/listenme-mcp-server

@boxverse_ai/listenme-mcp-server

MCP server for ListenME — product research task management via Boxverse AI.

Provides 19 tools for managing research tasks, reviewing user feedback, and generating insights through the Model Context Protocol (MCP).

Quick Start

npx @boxverse_ai/listenme-mcp-server

Or install globally:

npm install -g @boxverse_ai/listenme-mcp-server
listenme-mcp

Setup

1. Initialize config

npx @boxverse_ai/listenme-mcp-server init <apiKey> <apiSecret>

This creates ~/.listenme/config.json with your credentials.

You can optionally override the base URLs:

npx @boxverse_ai/listenme-mcp-server init <apiKey> <apiSecret> <walletBaseUrl> <aiBaseUrl>

2. Or use environment variables

| Variable | Description | Default | |----------|-------------|---------| | LISTENME_API_KEY | API key from Boxverse dashboard | — | | LISTENME_API_SECRET | API secret | — | | LISTENME_WALLET_BASE_URL | Wallet API base URL | https://api-wallet.boxtradex.io/wallet | | LISTENME_AI_BASE_URL | AI API base URL | https://api-ai.boxtradex.io/ai | | LISTENME_LANG | Response language | en |

Environment variables take precedence over config file values.

MCP Client Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "listenme": {
      "command": "npx",
      "args": ["-y", "@boxverse_ai/listenme-mcp-server"],
      "env": {
        "LISTENME_API_KEY": "your-key",
        "LISTENME_API_SECRET": "your-secret"
      }
    }
  }
}

If you've already run init, you can omit the env block:

{
  "mcpServers": {
    "listenme": {
      "command": "npx",
      "args": ["-y", "@boxverse_ai/listenme-mcp-server"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "listenme": {
      "command": "npx",
      "args": ["-y", "@boxverse_ai/listenme-mcp-server"],
      "env": {
        "LISTENME_API_KEY": "your-key",
        "LISTENME_API_SECRET": "your-secret"
      }
    }
  }
}

SSE Transport

For HTTP-based clients, use SSE mode:

npx @boxverse_ai/listenme-mcp-server --sse
# or
SSE=1 SSE_PORT=3001 npx @boxverse_ai/listenme-mcp-server

Endpoints:

• SSE: http://localhost:3001/sse
• Messages: POST http://localhost:3001/messages
• Health: GET http://localhost:3001/health

Tools (21)

Agent Management (Wallet API)

| Tool | Description | |------|-------------| | listenme_create_ai_agent | Create a new AI agent | | listenme_list_agents | List AI agents with filtering and pagination |

Task Management (Wallet API)

| Tool | Description | |------|-------------| | listenme_get_task_types | List available task type categories | | listenme_create_task | Create a new research task | | listenme_update_task | Update an existing task | | listenme_delete_task | Delete a task | | listenme_list_tasks | List tasks with filtering and pagination | | listenme_get_task_detail | Get full task details | | listenme_get_task_log | Get task submission logs | | listenme_get_task_reward_list | List task rewards | | listenme_manual_submit | Manually submit a task completion | | listenme_refund_task | Refund a task | | listenme_reward_review | Review and approve/reject reward submissions |

Feedback & Analysis (AI API)

| Tool | Description | |------|-------------| | listenme_get_feedback_overview | Overview stats for a task's feedback | | listenme_get_feedback_list | List feedback entries with filters | | listenme_get_topics | Get discovered feedback topics | | listenme_get_feedback_analysis | Detailed feedback analysis | | listenme_get_key_insights | Retrieve generated key insights | | listenme_generate_key_insights | Trigger AI insight generation | | listenme_get_feedback_detail | Get a single feedback entry | | listenme_update_feedback_log | Update feedback status/notes |

License

MIT