hockeystack-revenue-agents-mcp

MCP server for the HockeyStack Revenue Agents API. Exposes the full v1 surface (agents, conversations, tasks, credits) as MCP tools.

Install / run

Run directly with npx (no install needed):

HOCKEYSTACK_API_TOKEN=hsr_live_... npx hockeystack-revenue-agents-mcp

Or install globally:

npm install -g hockeystack-revenue-agents-mcp
HOCKEYSTACK_API_TOKEN=hsr_live_... hockeystack-revenue-agents-mcp

Configuration

| Env var | Required | Default | | ------------------------ | -------- | ---------------------------------------------------------------- | | HOCKEYSTACK_API_TOKEN | yes | — | | HOCKEYSTACK_BASE_URL | no | https://app.hockeystack.com/api/revenue-agents/v1 |

Get a token from the HockeyStack workspace settings. Tokens look like hsr_live_<hex>.

Claude Desktop / Cursor / Claude Code

Add to your MCP client config (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "hockeystack": {
      "command": "npx",
      "args": ["-y", "hockeystack-revenue-agents-mcp"],
      "env": {
        "HOCKEYSTACK_API_TOKEN": "hsr_live_..."
      }
    }
  }
}

Tools

Service

• hs_health — Liveness probe (unauthenticated).
• hs_me — Token introspection.

Agents

• hs_list_company_agents, hs_init_company_agent, hs_get_company_agent, hs_delete_company_agent
• hs_list_deal_agents, hs_init_deal_agent, hs_get_deal_agent, hs_delete_deal_agent

Conversations (deal)

• hs_create_deal_conversation, hs_list_deal_conversations, hs_delete_deal_conversation
• hs_list_deal_conversation_messages, hs_send_deal_message, hs_get_deal_message_job

Conversations (company)

• hs_create_company_conversation, hs_list_company_conversations, hs_delete_company_conversation
• hs_list_company_conversation_messages, hs_send_company_message, hs_get_company_message_job

hs_send_*_message runs the agent asynchronously and polls the resulting job until it completes (default 5 min wait, configurable via wait_seconds). If the wait elapses, the pending job is returned and you can resume polling with hs_get_*_message_job.

Tasks

• hs_list_tasks, hs_get_task, hs_create_task, hs_update_task, hs_delete_task

Credits

• hs_credits_balance, hs_credits_usage, hs_credits_operations

Local development

npm install
npm run build
HOCKEYSTACK_API_TOKEN=hsr_live_... node build/index.js

License

MIT