`get_hottest`

Pack: lobsters · Endpoint: https://gateway.pipeworx.io/lobsters/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_hottest for the schema, then POST the same URL with its arguments for the data.

Get trending stories from Lobsters. Returns title, URL, score, comment count, and tags for each story.

Example call

Arguments

{}

curl

curl -X POST https://gateway.pipeworx.io/lobsters/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_hottest","arguments":{}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_hottest', {});

Response shape

Field	Type	Description
`count`	number	Number of stories returned
`stories`	array	List of trending stories

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of stories returned"
    },
    "stories": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "short_id": {
            "type": "string",
            "description": "Unique short ID for the story"
          },
          "url": {
            "type": "string",
            "description": "Story URL"
          },
          "comments_url": {
            "type": "string",
            "description": "URL to view comments on Lobsters"
          },
          "title": {
            "type": "string",
            "description": "Story title"
          },
          "score": {
            "type": "number",
            "description": "Total score (upvotes - downvotes)"
          },
          "comment_count": {
            "type": "number",
            "description": "Number of comments"
          },
          "created_at": {
            "type": "string",
            "description": "ISO timestamp of story creation"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags associated with the story"
          },
          "description": {
            "type": "string",
            "description": "Plain text description or null"
          }
        }
      },
      "description": "List of trending stories"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "lobsters": {
      "url": "https://gateway.pipeworx.io/lobsters/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_hottest