Search / com.honesthook/social-data
social-data
R0· no sign-inInstagram, TikTok, Threads, Bluesky and 8 more: one API, one key, one JSON shape
v1.0.1 · active · website · descriptor JSON · versions
Search / com.honesthook/social-data
R0· no sign-inInstagram, TikTok, Threads, Bluesky and 8 more: one API, one key, one JSON shape
v1.0.1 · active · website · descriptor JSON · versions
{
"mcpServers": {
"social-data": {
"type": "http",
"url": "https://honesthook.com/api/mcp"
}
}
}claude mcp add --transport http social-data https://honesthook.com/api/mcp[mcp_servers.social-data]
url = "https://honesthook.com/api/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"social-data": {
"type": "remote",
"url": "https://honesthook.com/api/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"social-data": {
"type": "http",
"url": "https://honesthook.com/api/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=social-data&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vaG9uZXN0aG9vay5jb20vYXBpL21jcCJ9"
}{
"servers": {
"social-data": {
"type": "http",
"url": "https://honesthook.com/api/mcp"
}
}
}{
"mcpServers": {
"social-data": {
"httpUrl": "https://honesthook.com/api/mcp"
}
}
}extensions:
"social-data":
enabled: true
name: "social-data"
type: streamable_http
uri: "https://honesthook.com/api/mcp"
timeout: 300
protocol.modernsupports 2026-07-28 (server/discover)protocol.statelessanswers without a sessionprotocol.transportstreamable HTTPprotocol.list_ttltools/list carries no ttlMs, so clients re-fetch itauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotationsonly 6 of 12 tools declare readOnlyHint or destructiveHinttools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: list_platforms (destructiveHint, idempotentHint, openWorldHint); pricing (destructiveHint, idempotentHint, openWorldHint); fetch_profile (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …tools.token_costabout 2,419 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes19 tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageprofile_historychangedinput schemafetch_postschangeddescription, input schemaRead the recent posts of one public profile: the text, likes, replies, reposts, quotes, the post URL and when it was published. Threads, Bluesky and Mastodon. Boosts and reposts of other people are filtered out — you get what the account itself wrote, its replies included. `limit` is optional on Bluesky and Mastodon, and each has its own range: a value outside it is rejected rather than silently trimmed. Threads does not accept `limit` at all and answers 400 if you send it — its posts arrive inside the same document as the profile, so there is no upstream to ask for a count. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit.
Read the recent posts of one public profile: the text, likes, replies, reposts, quotes, the post URL and when it was published. Threads, Bluesky, Mastodon and Telegram. Boosts and reposts of other people are filtered out — you get what the account itself wrote, its replies included. `limit` is optional on Bluesky and Mastodon, and each has its own range: a value outside it is rejected rather than silently trimmed. Threads does not accept `limit` at all and answers 400 if you send it — its posts arrive inside the same document as the profile, so there is no upstream to ask for a count. Telegram ignores `limit`: it returns every post in the public preview page, with no login and no bot token. Telegram's `followers` is always null on this endpoint — the preview page only prints the subscriber count abbreviated, not exact. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit.
fetch_profilechangeddescription, input schemaRead one public profile and get the numbers back: follower count, following count, posts count, bio, verified flag and avatar. Works on Instagram, TikTok, Threads, Bluesky, Mastodon, GitHub, Pinterest, SoundCloud, Linktree and Medium. Mastodon handles are always `user@instance` — the local name alone identifies nobody. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit.
Read one public profile and get the numbers back: follower count, following count, posts count, bio, verified flag and avatar. Works on Instagram, TikTok, Threads, Bluesky, Mastodon, GitHub, Pinterest, SoundCloud, Linktree, Medium and Telegram. Mastodon handles are always `user@instance` — the local name alone identifies nobody. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit.
list_platformschangeddescriptionList every social platform HonestHook can read right now — the platforms you'd otherwise write a scraper for: Instagram, TikTok, Threads, Bluesky, Mastodon, GitHub, Pinterest, SoundCloud, Linktree, Medium — and what a handle looks like on each one. Use this before asking for a profile, to check the platform is covered and the handle format is right. No API key needed, and it costs 0 credits.
List every social platform HonestHook can read right now — the platforms you'd otherwise write a scraper for: Instagram, TikTok, Threads, Bluesky, Mastodon, GitHub, Pinterest, SoundCloud, Linktree, Medium, Telegram — and what a handle looks like on each one. Use this before asking for a profile, to check the platform is covered and the handle format is right. No API key needed, and it costs 0 credits.
github_reposaddedThe public repositories of one GitHub account, with stars and forks. GitHub only — this is the one platform whose repositories we read. `limit` is optional: 30 by default, which is GitHub's own page size, and 100 at most, which is GitHub's ceiling. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit.
profile_historyaddedThe daily history of one public profile we have already archived: how its follower count moved, day by day. ⚠️ It only covers what was captured after somebody first asked for that profile — the series starts the day of the first call and never earlier, and the response says so in `covered_from`. A handle nobody ever asked for comes back with an empty series, which means 'we never looked', never 'nothing changed'. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit — free when nothing is found.
archive_trendsaddedHow a niche moved over a window we have already archived, grouped by item: where each account stood then and where it stands now. This is the question nobody can answer after the fact — nobody photographs the past retroactively. Call `archive_coverage` first for the valid niche ids and how far back the archive goes. `from` and `to` are ISO 8601; without them you get the last 7 days, and the archive caps any window at 90 days. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit — charged even when the result is empty.
archive_moversaddedWho grew and who shrank most in a niche, over a window we have already archived — the comparison done for you, ranked. Call `archive_coverage` first: it lists the valid niche ids and how far back each one goes. `hours` is 1 to 720 (30 days) and defaults to 24; `limit` is 1 to 100 and defaults to 20. A value outside the range is rejected rather than silently trimmed. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 10 credits — free when nothing moved.
fetch_postschangedtitle, description, input schemaRead the recent posts of one public profile: the text, likes, replies, reposts, quotes, the post URL and when it was published. Threads, Bluesky and Mastodon. Boosts and reposts of other people are filtered out — you get what the account itself wrote, its replies included. `limit` is optional and each platform has its own range: a value outside it is rejected rather than silently trimmed, and Threads ignores `limit` entirely, because its posts arrive inside the same document as the profile. Requires an API key sent as `Authorization: Bearer <key>`; costs 1 credit.
Read the recent posts of one public profile: the text, likes, replies, reposts, quotes, the post URL and when it was published. Threads, Bluesky and Mastodon. Boosts and reposts of other people are filtered out — you get what the account itself wrote, its replies included. `limit` is optional on Bluesky and Mastodon, and each has its own range: a value outside it is rejected rather than silently trimmed. Threads does not accept `limit` at all and answers 400 if you send it — its posts arrive inside the same document as the profile, so there is no upstream to ask for a count. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit.
fetch_profilechangedtitle, descriptionRead one public profile and get the numbers back: follower count, following count, posts count, bio, verified flag and avatar. Works on Instagram, TikTok, Threads, Bluesky, Mastodon, GitHub, Pinterest, SoundCloud, Linktree and Medium. Mastodon handles are always `user@instance` — the local name alone identifies nobody. Requires an API key sent as `Authorization: Bearer <key>`; costs 1 credit.
Read one public profile and get the numbers back: follower count, following count, posts count, bio, verified flag and avatar. Works on Instagram, TikTok, Threads, Bluesky, Mastodon, GitHub, Pinterest, SoundCloud, Linktree and Medium. Mastodon handles are always `user@instance` — the local name alone identifies nobody. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit.
Showing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+dns-namespace +website +reachable +uptime-100% +updated-16d-ago -no-repository
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://honesthook.com/api/mcp streamable-http | none | yes | 100% | 268 ms | 2026-07-28 | 2026-10-20 |
archive_coverageread-only | How much trend history HonestHook already holds, by niche — AI agents, developer tools, indie SaaS — with the most recent hourly window captured. Use this to check whether the archive goes back far enough for your question before you build on it. No API key needed, and it costs 0 credits. |
archive_movers | Who grew and who shrank most in a niche, over a window we have already archived — the comparison done for you, ranked. Call `archive_coverage` first: it lists the valid niche ids and how far back each one goes. `hours` is 1 to 720 (30 days) and defaults to 24; `limit` is 1 to 100 and defaults to 20. A value outside the range is rejected rather than silently trimmed. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 10 credits — free when nothing moved. |
archive_trends | How a niche moved over a window we have already archived, grouped by item: where each account stood then and where it stands now. This is the question nobody can answer after the fact — nobody photographs the past retroactively. Call `archive_coverage` first for the valid niche ids and how far back the archive goes. `from` and `to` are ISO 8601; without them you get the last 7 days, and the archive caps any window at 90 days. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit — charged even when the result is empty. |
check_balanceread-only | How many credits are left on your HonestHook API key: the free monthly allowance, the purchased balance, when the allowance renews, and what this cycle spent, broken down by endpoint. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key. Checking the balance costs 0 credits — reading it never changes it. |
fetch_posts | Read the recent posts of one public profile: the text, likes, replies, reposts, quotes, the post URL and when it was published. Threads, Bluesky, Mastodon and Telegram. Boosts and reposts of other people are filtered out — you get what the account itself wrote, its replies included. `limit` is optional on Bluesky and Mastodon, and each has its own range: a value outside it is rejected rather than silently trimmed. Threads does not accept `limit` at all and answers 400 if you send it — its posts arrive inside the same document as the profile, so there is no upstream to ask for a count. Telegram ignores `limit`: it returns every post in the public preview page, with no login and no bot token. Telegram's `followers` is always null on this endpoint — the preview page only prints the subscriber count abbreviated, not exact. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit. |
fetch_profile | Read one public profile and get the numbers back: follower count, following count, posts count, bio, verified flag and avatar. Works on Instagram, TikTok, Threads, Bluesky, Mastodon, GitHub, Pinterest, SoundCloud, Linktree, Medium and Telegram. Mastodon handles are always `user@instance` — the local name alone identifies nobody. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit. |
get_docsread-only | How to authenticate, how the response envelope is shaped, what happens when credits run out, and where to get a free key with 1,000 credits a month and no card. Read this before writing code against the API. No API key needed, and it costs 0 credits. |
github_repos | The public repositories of one GitHub account, with stars and forks. GitHub only — this is the one platform whose repositories we read. `limit` is optional: 30 by default, which is GitHub's own page size, and 100 at most, which is GitHub's ceiling. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit. |
list_endpointsread-only | List every HonestHook API endpoint: public profiles (followers, following, posts count, bio, verified), recent posts, the historical trend archive, and per-profile history. Returns the URL and the query parameters for each, and says which ones you can call as a tool on this server — profiles through `fetch_profile`, posts through `fetch_posts` — and which are HTTP only. No API key needed, and it costs 0 credits. |
list_platformsread-only | List every social platform HonestHook can read right now — the platforms you'd otherwise write a scraper for: Instagram, TikTok, Threads, Bluesky, Mastodon, GitHub, Pinterest, SoundCloud, Linktree, Medium, Telegram — and what a handle looks like on each one. Use this before asking for a profile, to check the platform is covered and the handle format is right. No API key needed, and it costs 0 credits. |
pricingread-only | What each HonestHook call costs in credits, and which calls are free when they find nothing. Includes the free monthly allowance that every key gets with no card, at https://honesthook.com/docs#key. Use this to estimate cost before building. No API key needed, and it costs 0 credits. |
profile_history | The daily history of one public profile we have already archived: how its follower count moved, day by day. ⚠️ It only covers what was captured after somebody first asked for that profile — the series starts the day of the first call and never earlier, and the response says so in `covered_from`. A handle nobody ever asked for comes back with an empty series, which means 'we never looked', never 'nothing changed'. Requires an API key sent as `Authorization: Bearer <key>` — free key at https://honesthook.com/docs#key; costs 1 credit — free when nothing is found. |
Schemas: list_tools.
{
"name": "com.honesthook/social-data",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
"remotes": [
{
"url": "https://honesthook.com/api/mcp",
"type": "streamable-http"
}
],
"version": "1.0.1",
"websiteUrl": "https://honesthook.com",
"description": "Instagram, TikTok, Threads, Bluesky and 8 more: one API, one key, one JSON shape"
}