Soulseek MCP Server

Instructions

Implementation Reference

• src/index.ts:172-185 (handler)

  MCP CallTool handler for 'get_status': fetches status from soulseekClient and returns formatted text response.

  case 'get_status': {
    const status = soulseekClient.getStatus();
  
    return {
      content: [
        {
          type: 'text',
          text: status.connected
            ? `Connected to Soulseek as: ${status.username}`
            : 'Not connected to Soulseek. Will connect automatically on first search or download.',
        },
      ],
    };
  }

• src/index.ts:110-116 (schema)

  Tool schema registration in ListTools response: name, description, and empty input schema for get_status.

  {
    name: 'get_status',
    description: 'Check the current connection status to the Soulseek network.',
    inputSchema: {
      type: 'object',
      properties: {},
    },

• src/soulseek-client.ts:165-170 (helper)

  Core implementation of getStatus() method in SoulseekClientWrapper that returns connection status and username.

  getStatus(): { connected: boolean; username: string | null } {
    return {
      connected: this.connected,
      username: this.connected ? this.username : null,
    };
  }