Servidor MCP

social-data

com.honesthook/social-data
Datos y analítica Redes sociales Público y accesible MCP 2026-07-28

Qué hace este MCP

Retrieves public profiles, posts, platform coverage, and historical trend data across multiple social and creator platforms.

archive_coverage
Archive coverage by niche
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
archive_movers
Biggest movers in a niche
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.
Esquema de entrada
{'type': 'object', 'required': ['niche'], 'properties': {'hours': {'type': 'integer', 'description': 'How many hours back the window goes. Optional, 1 to 720, 24 by default. Outside that range the API answers 400.'}, 'limit': {'type': 'integer', 'description': 'How many movers to return. Optional, 1 to 100, 20 by default. Outside that range the API answers 400.'}, 'niche': {'type': 'string', 'description': 'The niche id, as `archive_coverage` returns it — for example `ai-agents`. A niche we do not archive is refused by the API.'}}, 'additionalProperties': False}
archive_trends
Niche trend history
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.
Esquema de entrada
{'type': 'object', 'required': ['niche'], 'properties': {'to': {'type': 'string', 'description': 'End of the window, ISO 8601. Optional, defaults to now.'}, 'from': {'type': 'string', 'description': 'Start of the window, ISO 8601 (`2026-09-05T00:00:00Z`). Optional. Anything else answers 400 rather than being guessed at.'}, 'limit': {'type': 'integer', 'description': 'How many items to return. Optional.'}, 'niche': {'type': 'string', 'description': 'The niche id, as `archive_coverage` returns it — for example `ai-agents`. A niche we do not archive is refused by the API.'}}, 'additionalProperties': False}
check_balance
Check credit balance
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
fetch_posts
Fetch recent 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 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.
Esquema de entrada
{'type': 'object', 'required': ['platform', 'handle'], 'properties': {'limit': {'type': 'integer', 'description': 'How many posts to return. Optional, and Bluesky and Mastodon only. The valid range depends on the platform and the API rejects a value outside it instead of trimming it, so the count you get is never quietly smaller than the count you asked for. Threads answers 400 if you send this at all: its posts come from the profile document, not from a query you can size.'}, 'handle': {'type': 'string', 'description': 'The account handle, without the leading @. On Mastodon it must be `user@instance`, because the same local name exists on many servers.'}, 'platform': {'enum': ['bluesky', 'mastodon', 'threads'], 'type': 'string', 'description': 'Which platform to read the posts from.'}}, 'additionalProperties': False}
fetch_profile
Fetch a public 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 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.
Esquema de entrada
{'type': 'object', 'required': ['platform', 'handle'], 'properties': {'handle': {'type': 'string', 'description': 'The account handle, without the leading @. On Mastodon it must be `user@instance`, because the same local name exists on many servers.'}, 'platform': {'enum': ['bluesky', 'github', 'instagram', 'linktree', 'mastodon', 'medium', 'pinterest', 'soundcloud', 'threads', 'tiktok'], 'type': 'string', 'description': 'Which platform to read the profile from.'}}, 'additionalProperties': False}
get_docs
API docs in one page
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
github_repos
List a GitHub account's 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.
Esquema de entrada
{'type': 'object', 'required': ['handle'], 'properties': {'limit': {'type': 'integer', 'description': 'How many repositories to return. Optional, 30 by default, 100 at most. Outside that range the API answers 400.'}, 'handle': {'type': 'string', 'description': 'The GitHub username, without the leading @: letters, digits and single hyphens, up to 39 characters.'}}, 'additionalProperties': False}
list_endpoints
List API endpoints
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
list_platforms
List supported platforms
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 — 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.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
pricing
Pricing and free allowance
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.
Solo lectura
Esquema de entrada
{'type': 'object', 'properties': {}, 'additionalProperties': False}
profile_history
Daily history of a profile
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.
Esquema de entrada
{'type': 'object', 'required': ['platform', 'handle'], 'properties': {'to': {'type': 'string', 'description': 'End of the window, ISO 8601. Optional.'}, 'from': {'type': 'string', 'description': 'Start of the window, ISO 8601. Optional. Anything else answers 400.'}, 'limit': {'type': 'integer', 'description': 'How many days to return. Optional.'}, 'handle': {'type': 'string', 'description': 'The account handle, without the leading @. On Mastodon it must be `user@instance`, because the same local name exists on many servers.'}, 'platform': {'enum': ['bluesky', 'github', 'instagram', 'linktree', 'mastodon', 'medium', 'pinterest', 'soundcloud', 'threads', 'tiktok'], 'type': 'string', 'description': 'Which platform the archived profile is on.'}}, 'additionalProperties': False}
Añadido
github_repos
27 de September de 2026 a las 02:40
Añadido
profile_history
27 de September de 2026 a las 02:40
Añadido
archive_trends
27 de September de 2026 a las 02:40
Añadido
archive_movers
27 de September de 2026 a las 02:40
Modificado
fetch_posts
27 de September de 2026 a las 02:40
Modificado
fetch_profile
27 de September de 2026 a las 02:40
Modificado
check_balance
27 de September de 2026 a las 02:40
Modificado
get_docs
27 de September de 2026 a las 02:40
Modificado
archive_coverage
27 de September de 2026 a las 02:40
Modificado
pricing
27 de September de 2026 a las 02:40
Modificado
list_endpoints
27 de September de 2026 a las 02:40
Modificado
list_platforms
27 de September de 2026 a las 02:40
Añadido
fetch_posts
25 de September de 2026 a las 02:40
Añadido
fetch_profile
25 de September de 2026 a las 02:40
Añadido
check_balance
25 de September de 2026 a las 02:40
Añadido
get_docs
25 de September de 2026 a las 02:40
Añadido
archive_coverage
25 de September de 2026 a las 02:40
Añadido
pricing
25 de September de 2026 a las 02:40
Añadido
list_endpoints
25 de September de 2026 a las 02:40
Añadido
list_platforms
25 de September de 2026 a las 02:40