Mastodon

liveSocialMediaNews

Search accounts and statuses, browse trending posts, and read the public timeline on mastodon.social

4tools

0msauth

free tier50 calls/day

Tools

searchrequired: query

Search Mastodon for accounts, statuses, or hashtags. Returns matching profiles, posts, and tags with follower counts and engagement metrics.

Parameters

NameTypeDescription

queryreqstringSearch query string

typeoptstringType of results: accounts, statuses, or hashtags (default: statuses)

limitoptnumberNumber of results to return (default: 10, max: 40)

▶Try it

Response

get_trending

Get currently trending posts on Mastodon. Returns popular statuses with engagement counts, authors, and trending tags.

Parameters

NameTypeDescription

limitoptnumberNumber of trending statuses to return (default: 10, max: 40)

▶Try it

Response

get_accountrequired: id

Get a Mastodon account profile by ID (e.g., '109382839472938472'). Returns bio, follower/following counts, post history, and verification status.

Parameters

NameTypeDescription

idreqstringNumeric Mastodon account ID (e.g. "109302436954721982")

▶Try it

Response

get_timeline

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

Parameters

NameTypeDescription

limitoptnumberNumber of statuses to return (default: 20, max: 40)

▶Try it

Response

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools

bash

curl -X POST https://gateway.pipeworx.io/mastodon/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool

bash

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

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript

import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search", {"query":"example"});

ask_pipeworx

// Or ask in plain English:
const answer = await px.ask("search accounts and statuses, browse trending posts, and read the public timeline on mastodon");

Related packs

Other Pipeworx packs in the same categories (Social, Media, News):

MCP Config

claude_desktop_config.json

{
  "mcpServers": {
    "pipeworx-mastodon": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/mastodon/mcp"
      ]
    }
  }
}