Skip to main content
Glama
pulse-mcp

pulse-mcp

by patwalls

pulse-mcp

MCP server for Pulse — a free, agent-first social-post metrics API. Give any MCP client (Claude Desktop, Cursor, …) the numbers behind any public post: hand it a URL, get back views, likes, comments, and the publish date as clean JSON. No signup, no API key.

{ "mcpServers": { "pulse": { "command": "npx", "args": ["-y", "pulse-mcp"] } } }

That's it — drop it in your MCP config and your agent has five new tools.

Tools

Tool

Input

Output

metrics

one post URL (short links like vm.tiktok.com/t.co OK)

{ platform, views, likes, comments, shares, quotes, bookmarks, publishedAt, title, author, thumbnail }

metrics_batch

many URLs (mixed post + profile URLs welcome)

the same, one per URL (partial failures don't fail the batch)

history

one post or profile URL (+ optional since for the delta)

the recorded growth curve — { count, points } (posts: { t, views, likes, comments }, profiles: { t, followers, posts }), a snapshot per fresh fetch

profile

one profile URL

account-level metrics — { handle, name, followers, following, posts, verified, avatar } (YouTube, TikTok, Instagram, X, Bluesky, Mastodon)

profile_batch

many profile URLs (max 50)

same as profile, one per URL — order preserved; partial failures don't fail the batch. Compare follower counts across a list of creators.

Example — ask your agent "how did this video do?" with a link, and it gets:

{
  "platform": "youtube",
  "views": 1781088936,
  "likes": 19147197,
  "comments": null,
  "publishedAt": "2009-10-25T06:57:33.000Z",
  "title": "Rick Astley - Never Gonna Give You Up (Official Video)"
}

Related MCP server: meta-mcp

Platform coverage

Platform

Returns

Notes

YouTube

views, likes

X / Twitter

views, likes, comments, shares (retweets), quotes, bookmarks

views via X's own guest API (tweets since ~Dec 2022)

TikTok

views, likes, comments, shares

Bluesky

likes, comments, shares (reposts), quotes

public AppView API; Bluesky has no view counts

Mastodon

likes, boosts, replies

per-instance public REST API (major instances)

Instagram

views, likes, comments

public posts via the guest API

Threads

post metrics need a login

post metrics → login_required; profile metrics (followers/verified) work via /profile

LinkedIn

— (posts need login)

post metrics → login_required; profiles also login-walled

It reads each platform's own public pages from a residential IP, so it sees what a browser sees — and it's honest about the edges: a deleted/private post comes back content_unavailable, a login-walled one login_required, never a silent row of zeros.

Config

  • Free — no account, no key, no wallet.

  • PULSE_API_URL — override the backend (defaults to https://pulse.walls.sh).

Built in public as Wall #002 of walls.sh. Docs: https://pulse.walls.sh/docs · machine-readable: /llms.txt · OpenAPI.

MIT.

Available Tools

5 tools
historyA

Get the recorded metrics history of a post OR a profile — the growth curve. Every fresh metrics fetch records a { t, views, likes, comments, shares, quotes, bookmarks } snapshot (profiles: { t, followers, posts }); this returns the series (oldest first). Pass since (ISO-8601 or unix ms) to get only the points after that moment — poll the delta, not the whole series. An empty series means the URL hasn't been fetched yet: call metrics or profile on it to start the series.

Inputs: url (required), since.

metricsA

Get a public social post's metrics. Give a post URL (YouTube, X/Twitter incl. view counts, TikTok incl. photo posts, Bluesky, Mastodon (major instances), Instagram, Threads, LinkedIn — short links like vm.tiktok.com and t.co resolve automatically) and get normalized { platform, views, likes, comments, shares, quotes, bookmarks, publishedAt, title, author, thumbnail } — shares = reshares (X retweets, TikTok shares, Bluesky reposts); quotes = quote posts (X, Bluesky); bookmarks = saves (X). Free.

Inputs: url (required).

metrics_batchA

Get metrics for many posts and/or profiles in one call. Pass an array of URLs (max 50, mixed post and profile URLs welcome); returns { count, results }, order preserved — each result is the metrics object or { url, error }.

Inputs: urls (required).

profileA

Get account-level metrics for a profile URL — { platform, handle, name, followers, following, posts, likes, verified, avatar }. Live: YouTube channels (subscribers), TikTok users (exact counts + total hearts), Instagram accounts (exact counts), X accounts (followers/following/posts), Bluesky accounts (exact counts), Mastodon accounts (exact, major instances). Threads/LinkedIn profiles need a login.

Inputs: url (required).

profile_batchA

Get account-level metrics for many profile URLs in one call — same as profile but up to 50 URLs at once. Mixed platforms welcome (YouTube, TikTok, Instagram, X, Bluesky, Mastodon). Returns { count, results }, order preserved — each result is a profile object or { url, error }. Useful for comparing follower counts across a list of creators/accounts.

Inputs: urls (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a distinct purpose: single metrics vs historical series vs batch metrics vs single profile vs batch profile. No overlap in functionality.

    Naming Consistency5/5

    Consistent noun naming for singletons (metrics, profile, history) and noun_batch for batch variants (metrics_batch, profile_batch). Clear and predictable pattern.

    Tool Count5/5

    5 tools cover the core operations for social media metrics retrieval: single and batch for posts and profiles, plus history. Well-scoped without excess.

    Completeness4/5

    Covers essential retrieval operations, but lacks an explicit endpoint to list supported platforms or trigger a refresh. Minor gap for an otherwise complete surface.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive Model Context Protocol (MCP) server that provides tools for interacting with the SocialData API. This server allows you to fetch Twitter/X data, monitor user activity, and analyze social media engagement programmatically.
      7
      -
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server for reading Twitter/X engagement data and metrics, enabling AI agents to measure tweet performance, track mentions, analyze replies, and search tweets with engagement metrics.
      4
      4
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A remote MCP server that provides tools to query live Meta (Facebook+Instagram) and TikTok organic social data, such as follower counts, insights, recent posts, and aggregated overviews.
      -