`get_timeline`

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

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

Get recent posts from the public Mastodon timeline. Returns statuses with authors, timestamps, engagement counts, and content.

Parameters

Name	Type	Required	Description
`limit`	number	no	Number of statuses to return (default: 20, max: 40)

Example call

Arguments

{
  "limit": 25
}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_timeline', {
  "limit": 25
});

Response shape

Always returns: count, statuses

Field	Type	Description
`count`	number	Number of statuses returned
`statuses`	array	Recent public timeline posts

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of statuses returned"
    },
    "statuses": {
      "type": "array",
      "description": "Recent public timeline posts",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Status ID"
          },
          "created_at": {
            "type": "string",
            "description": "Post creation timestamp"
          },
          "url": {
            "type": "string",
            "description": "Status URL"
          },
          "content": {
            "type": "string",
            "description": "Post content/body"
          },
          "visibility": {
            "type": "string",
            "description": "Visibility level"
          },
          "favourites_count": {
            "type": "number",
            "description": "Number of favorites"
          },
          "reblogs_count": {
            "type": "number",
            "description": "Number of reblogs/shares"
          },
          "replies_count": {
            "type": "number",
            "description": "Number of replies"
          },
          "language": {
            "type": [
              "string",
              "null"
            ],
            "description": "Post language code"
          },
          "sensitive": {
            "type": "boolean",
            "description": "Content warning flag"
          },
          "spoiler_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "Content warning text"
          },
          "tags": {
            "type": "array",
            "description": "Hashtags in post",
            "items": {
              "type": "string"
            }
          },
          "account": {
            "type": "object",
            "description": "Author account info",
            "properties": {
              "id": {
                "type": "string",
                "description": "Account ID"
              },
              "username": {
                "type": "string",
                "description": "Username"
              },
              "acct": {
                "type": "string",
                "description": "Full account address"
              },
              "display_name": {
                "type": "string",
                "description": "Display name"
              }
            }
          }
        }
      }
    }
  },
  "required": [
    "count",
    "statuses"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

get_timeline