get_newest

Pack: lobsters · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

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

Get latest stories posted to Lobsters. Returns title, URL, publication time, score, 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_newest","arguments":{}}}'

TypeScript (@pipeworx/sdk)

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

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

Response shape

FieldTypeDescription
countnumberNumber of stories returned
storiesarrayList of newest 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 newest stories"
    }
  }
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the lobsters pack
{
  "mcpServers": {
    "lobsters": {
      "url": "https://gateway.pipeworx.io/lobsters/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build October 30, 2026