# Usefulapi Groove Hq MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.usefulapi%2Fgroove-hq
Registry id: `mcp-registry/io.usefulapi/groove-hq`
Status: auth-required (checked 2026-10-27T05:43:10.385Z)

## Verdict

Usefulapi Groove Hq MCP server answered 100% of Glimind's liveness checks over 30 days, better than 42% of MCP servers, with 63 ms median handshake and 0 outages in 90 days. Its agent-readiness grade is A (96/100) across 16 tools, costing an agent about 2,424 tokens to load. Checked every few minutes; no tool is ever called.

## Measurements (30 days)

| Metric | Value | Better than |
|---|---|---|
| Uptime, 30 days | 100% | 42% of MCP servers |
| Median handshake latency | 63 ms | 88% of MCP servers |
| p95 handshake latency | 254 ms | — |
| Checks in 30 days | 219 | — |
| Outages, 90 days | 0 | — |
| Median recovery | — | — |
| Agent-readiness score | 96/100 (A) | 82% of MCP servers |
| Tools | 16 | — |
| Tool-list size for an agent | ~2,424 tokens | 50% of MCP servers |
| Days observed | 28 | — |

## Install

```json
{
  "mcpServers": {
    "usefulapi-groove-hq-mcp-server": {
      "type": "http",
      "url": "https://groove-hq.usefulapi.io/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http usefulapi-groove-hq-mcp-server https://groove-hq.usefulapi.io/mcp
```

## Tools (16)

- `groove_assign_conversation`: ASSIGNS a conversation to an agent and/or team. Pass agent_id, team_id, or both (at least one is required). Groove GraphQL: conversationAssign.
- `groove_close_conversation`: CLOSES a conversation (marks it resolved) in the shared inbox. Groove GraphQL: conversationClose.
- `groove_get_contact`: Get a single contact by id — name, email, role, type, and conversation count. Groove GraphQL: contact(contactId: ID!).
- `groove_get_conversation`: Get a single conversation by id — subject, state, assignment, contact, channel, counts, and tags. Groove GraphQL: conversation(id: ID!).
- `groove_list_agents`: List agents (support staff / users) in the account, with role and state. Paginate with first/after. Groove GraphQL: agents.
- `groove_list_channels`: List channels (mailboxes / inboxes — email, chat, etc.) configured in the account. Paginate with first/after. Groove GraphQL: channels.
- `groove_list_contacts`: List customer contacts (people who wrote in). Optional keyword search over name/email; paginate with first/after. Groove GraphQL: contacts(keywords: String).
- `groove_list_conversations`: List support conversations (tickets) in the shared inbox, with rich filters. Filter by state, channel_id, folder_id, tag_name, assigned, starred, or keywords; p
- `groove_list_folders`: List folders (saved views / smart folders that group conversations), with conversation counts. Paginate with first/after. Groove GraphQL: folders.
- `groove_list_tags`: List tags defined in the account (id, name, color) — use tag ids with the tag/untag write tools. Paginate with first/after. Groove GraphQL: tags.
- `groove_list_teams`: List teams (groups of agents that conversations can be assigned to). Paginate with first/after. Groove GraphQL: teams.
- `groove_open_conversation`: RE-OPENS a closed/snoozed conversation in the shared inbox. Groove GraphQL: conversationOpen.
- `groove_snooze_conversation`: SNOOZES a conversation until the given time (ISO8601) — it drops out of the inbox until then. Groove GraphQL: conversationSnooze.
- `groove_star_conversation`: STARS a conversation (flags it for attention) in the shared inbox. Groove GraphQL: conversationStar.
- `groove_tag_conversation`: ADDS tags (by tag id) to a conversation. Use groove_list_tags to find tag ids. Groove GraphQL: conversationTag.
- `groove_untag_conversation`: REMOVES tags (by tag id) from a conversation. Use groove_list_tags to find tag ids. Groove GraphQL: conversationUntag.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.