How should TopYappers be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this mcp.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Crawler Summary

TopYappers answer-first brief

# TopYappers Social media intelligence for AI agents. Access viral content discovery, influencer search across TikTok, Instagram & YouTube, and trending song charts — all through a single MCP connection. ## What it does TopYappers gives AI agents real-time access to social media data across three domains: - **Viral Content** — Discover trending TikTok posts filtered by category, country, virality score (views÷followers), date range, music/sound, and opening hooks. Understand what's going viral and why. - **Creators & Influencers** — Search a database of 30M+ creators across TikTok, Instagram, and YouTube using 20+ filters including AI-analyzed niches, promoted products, follower ranges, engagement rates, country, language, and hashtags. Creator search is free — you only pay when fetching full profiles. - **Trending Songs** — Access weekly song chart rankings by country, track new chart entries, search by title or artist, view historical performance, and compare charts week-over-week. ## Tools | Tool | Description | Cost | |------|-------------|------| | `search_viral_content` | Find viral TikTok posts by category, country, views, virality score, dates, music, hooks | 1 credit/result | | `search_creators` | Search influencers across TikTok, Instagram, YouTube with 20+ filters | **Free** | | `get_creator_profiles` | Fetch full creator profiles — followers, engagement, email, bio, niches, promoted products | 1 credit/creator | | `search_videos` | Search videos by engagement metrics, hashtags, text in descriptions | 1 credit/video | | `get_song_rankings` | Country or global trending song chart rankings | 10 credits | | `get_new_song_entries` | Newly charting songs that just entered rankings | 10 credits | | `search_songs` | Search songs by title or artist name | 10 credits | | `get_song_history` | Track a song's chart performance over time | 10 credits | | `compare_song_rankings` | Compare song charts between two weeks | 10 credits | | `get_song_countries` | List available countries for song data | 10 credits | | `get_song_weeks` | List available weeks for a country | 10 credits | ## Use cases - **Influencer marketing** — Find creators in specific niches who match a brand's target audience, with contact emails and engagement data - **Content strategy** — Analyze what's going viral in your category to inform content creation - **Trend monitoring** — Track trending songs and sounds before they peak, ideal for music marketing and content timing - **Competitive intelligence** — Discover which products competitors are promoting through influencers - **Market research** — Understand engagement patterns across countries, categories, and platforms ## Key features - **Credit-efficient design** — Creator search is free; agents find matching IDs first, then only fetch profiles for relevant creators - **Rich filtering** — 20+ filters for creators including AI-analyzed `nichesToPromote` for semantic niche matching - **Cross-platform** — Single interface for TikTok, Instagram, and YouTube data - **Built-in agent guidance** — Includes detailed instructions and prompt templates to help agents use tools effectively - **No data stored** — API keys are forwarded as Bearer tokens; nothing is stored on the server ## Authentication Requires a TopYappers API key passed as a Bearer token in the `Authorization` header. Get a key at [topyappers.com/profile](https://www.topyappers.com/profile). ## Links - [TopYappers Platform](https://www.topyappers.com) - [API Documentation](https://docs.topyappers.com) - [MCP Documentation](https://www.topyappers.com/mcp) - [GitHub](https://github.com/topyappers/topyappers-mcp) TopYappers Social media intelligence for AI agents. Access viral content discovery, influencer search across TikTok, Instagram & YouTube, and trending song charts — all through a single MCP connection. What it does TopYappers gives AI agents real-time access to social media data across three domains: - **Viral Content** — Discover trending TikTok posts filtered by category, country, virality score (views÷followers), Capability contract not published. No trust telemetry is available yet. Last updated 4/16/2026.

Freshness

Last checked 4/16/2026

Best For

TopYappers is best for general automation workflows where MCP compatibility matters.

Not Ideal For

Contract metadata is missing or unavailable for deterministic execution.

Evidence Sources Checked

editorial-content, Smithery, runtime-metrics, public facts pack

Card Facts Snapshot Contract Trust

Claim this agent

Agent DossierSmitherySafety: 86/100

TopYappers

MCPself-declared

Public facts

Change events

Artifacts

Freshness

Apr 16, 2026

Verifiededitorial-contentNo verified compatibility signals

Capability contract not published. No trust telemetry is available yet. Last updated 4/16/2026.

Trust evidence available

Trust score

Unknown

Compatibility

MCP

Freshness

Apr 16, 2026

Vendor

Topyappers

Artifacts

Benchmarks

Last release

Unpublished

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Capability contract not published. No trust telemetry is available yet. Last updated 4/16/2026.

View Source

Setup snapshot

1
Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content

Vendor (1)

Vendor

Topyappers

profilemedium

Observed Apr 16, 2026Source link Provenance

Compatibility (1)

Protocol compatibility

MCP

contractmedium

Observed Apr 16, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredSmithery

Extracted files

Examples

Snippets

Languages

Unknown

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredSmithery

Docs source

Smithery

Editorial quality

ready

Full README

TopYappers

Social media intelligence for AI agents. Access viral content discovery, influencer search across TikTok, Instagram & YouTube, and trending song charts — all through a single MCP connection.

What it does

TopYappers gives AI agents real-time access to social media data across three domains:

Viral Content — Discover trending TikTok posts filtered by category, country, virality score (views÷followers), date range, music/sound, and opening hooks. Understand what's going viral and why.
Creators & Influencers — Search a database of 30M+ creators across TikTok, Instagram, and YouTube using 20+ filters including AI-analyzed niches, promoted products, follower ranges, engagement rates, country, language, and hashtags. Creator search is free — you only pay when fetching full profiles.
Trending Songs — Access weekly song chart rankings by country, track new chart entries, search by title or artist, view historical performance, and compare charts week-over-week.

Tools

| Tool | Description | Cost | |------|-------------|------| | search_viral_content | Find viral TikTok posts by category, country, views, virality score, dates, music, hooks | 1 credit/result | | search_creators | Search influencers across TikTok, Instagram, YouTube with 20+ filters | Free | | get_creator_profiles | Fetch full creator profiles — followers, engagement, email, bio, niches, promoted products | 1 credit/creator | | search_videos | Search videos by engagement metrics, hashtags, text in descriptions | 1 credit/video | | get_song_rankings | Country or global trending song chart rankings | 10 credits | | get_new_song_entries | Newly charting songs that just entered rankings | 10 credits | | search_songs | Search songs by title or artist name | 10 credits | | get_song_history | Track a song's chart performance over time | 10 credits | | compare_song_rankings | Compare song charts between two weeks | 10 credits | | get_song_countries | List available countries for song data | 10 credits | | get_song_weeks | List available weeks for a country | 10 credits |

Use cases

Influencer marketing — Find creators in specific niches who match a brand's target audience, with contact emails and engagement data
Content strategy — Analyze what's going viral in your category to inform content creation
Trend monitoring — Track trending songs and sounds before they peak, ideal for music marketing and content timing
Competitive intelligence — Discover which products competitors are promoting through influencers
Market research — Understand engagement patterns across countries, categories, and platforms

Key features

Credit-efficient design — Creator search is free; agents find matching IDs first, then only fetch profiles for relevant creators
Rich filtering — 20+ filters for creators including AI-analyzed nichesToPromote for semantic niche matching
Cross-platform — Single interface for TikTok, Instagram, and YouTube data
Built-in agent guidance — Includes detailed instructions and prompt templates to help agents use tools effectively
No data stored — API keys are forwarded as Bearer tokens; nothing is stored on the server

Authentication

Requires a TopYappers API key passed as a Bearer token in the Authorization header. Get a key at topyappers.com/profile.

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

MissingSmithery

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

missing

Auth

None

Streaming

Data region

Unspecified

Protocol support

MCP: self-declared

Requires: none

Forbidden: none

Guardrails

Operational confidence: low

No positive guardrails captured.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/smithery-top-yappers/snapshot"

curl -s "https://xpersona.co/api/v1/agents/smithery-top-yappers/contract"

curl -s "https://xpersona.co/api/v1/agents/smithery-top-yappers/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

Do not use if

Contract metadata is missing or unavailable for deterministic execution.

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media

No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors

GITLAB_AI_CATALOGgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_PUBLIC_PROJECTSgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-openapi

Rank

Expose OpenAPI definition endpoints as MCP tools using the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-actix-web

Rank

An actix_web backend for the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

Machine Appendix

Contract JSON

{
  "contractStatus": "missing",
  "authModes": [],
  "requires": [],
  "forbidden": [],
  "supportsMcp": false,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": null,
  "outputSchemaRef": null,
  "dataRegion": null,
  "contractUpdatedAt": null,
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/smithery-top-yappers/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/smithery-top-yappers/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/smithery-top-yappers/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/smithery-top-yappers/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/smithery-top-yappers/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/smithery-top-yappers/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "MCP"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "SMITHERY",
      "generatedAt": "2026-04-17T02:04:01.839Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "MCP",
      "type": "protocol",
      "support": "unknown",
      "confidenceSource": "profile",
      "notes": "Listed on profile"
    }
  ],
  "flattenedTokens": "protocol:MCP|unknown|profile"
}

Facts JSON

[
  {
    "factKey": "vendor",
    "label": "Vendor",
    "value": "Topyappers",
    "category": "vendor",
    "href": "https://www.topyappers.com",
    "sourceUrl": "https://www.topyappers.com",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-04-16T06:45:17.853Z",
    "isPublic": true,
    "metadata": {}
  },
  {
    "factKey": "protocols",
    "label": "Protocol compatibility",
    "value": "MCP",
    "category": "compatibility",
    "href": "https://xpersona.co/api/v1/agents/smithery-top-yappers/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/smithery-top-yappers/contract",
    "sourceType": "contract",
    "confidence": "medium",
    "observedAt": "2026-04-16T06:45:17.853Z",
    "isPublic": true,
    "metadata": {}
  },
  {
    "factKey": "handshake_status",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "category": "security",
    "href": "https://xpersona.co/api/v1/agents/smithery-top-yappers/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/smithery-top-yappers/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true,
    "metadata": {}
  }
]

Change Events JSON

[]