`get_tag`

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

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

Search stories by tag (e.g., “rust”, “programming”, “security”). Returns matching stories with titles, URLs, scores, and tags.

Parameters

Name	Type	Required	Description
`tag`	string	yes	Tag name (e.g. “rust”, “programming”, “security”)

Example call

Arguments

{
  "tag": "rust"
}

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_tag","arguments":{"tag":"rust"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_tag', {
  "tag": "rust"
});

More examples

{
  "tag": "security"
}

Response shape

Always returns: tag, count, stories

Field	Type	Description
`tag`	string	The requested tag
`count`	number	Number of stories with this tag
`stories`	array	List of stories with the tag

Full JSON Schema

{
  "type": "object",
  "properties": {
    "tag": {
      "type": "string",
      "description": "The requested tag"
    },
    "count": {
      "type": "number",
      "description": "Number of stories with this tag"
    },
    "stories": {
      "type": "array",
      "description": "List of stories with the tag",
      "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)"
          },
          "upvotes": {
            "type": "number",
            "description": "Number of upvotes"
          },
          "downvotes": {
            "type": "number",
            "description": "Number of downvotes"
          },
          "comment_count": {
            "type": "number",
            "description": "Number of comments"
          },
          "created_at": {
            "type": "string",
            "description": "ISO timestamp of story creation"
          },
          "submitter": {
            "type": "string",
            "description": "Username of story submitter"
          },
          "tags": {
            "type": "array",
            "description": "Tags associated with the story",
            "items": {
              "type": "string"
            }
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Plain text description or null"
          }
        },
        "required": [
          "short_id",
          "url",
          "comments_url",
          "title",
          "score",
          "upvotes",
          "downvotes",
          "comment_count",
          "created_at",
          "submitter",
          "tags",
          "description"
        ]
      }
    }
  },
  "required": [
    "tag",
    "count",
    "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_tag