Back to Browse

X402 Social Media Data MCP Server

by Hiesem
Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Social listening and mentions: posts, search, comments, profiles, 10 platforms. Pay per call (x402)

About

Social listening and mentions: posts, search, comments, profiles, 10 platforms. Pay per call (x402)

Remote endpoints: streamable-http: https://social.duoleads.com/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry. Trust signals: trusted author (3/3 approved).

26 tools verified · Open access · No issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "com-duoleads-social-social-media-data": {
      "url": "https://social.duoleads.com/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

x402-social-media-data

Social media data API for AI agents: social listening and research across X (Twitter), Reddit, TikTok, Instagram, YouTube, Threads, Facebook ads, LinkedIn, Bluesky and Hacker News. Public posts, profiles, comments, video transcripts, cross-platform search and mentions in one shared schema. 26 routes, $0.01 to $0.025 per call, paid per request with x402 (USDC on Base). No API key, no signup.

This is the TypeScript client for https://social.duoleads.com. It is also part of duo-data-utilities (as client.social); this package has the social client only.

Install

npm install x402-social-media-data viem

viem creates the wallet account that pays. Node.js 20 or later.

Python: pip install x402-social-media-data (the same client in snake_case; source in python/).

Quick start

import { privateKeyToAccount } from "viem/accounts";
import { createClient } from "x402-social-media-data";

// Your wallet holds USDC on Base. Read the key from the environment, never a literal.
const client = createClient({ account: privateKeyToAccount(process.env.PAYER_KEY as `0x${string}`) });

const bsky = await client.blueskySearch({ q: "open source", limit: 10 });  // $0.01
const hn = await client.hackernewsSearch({ q: "x402" });                   // $0.01
const tweets = await client.xSearch({ q: "nasa" });                        // $0.02
const all = await client.socialSearch({ q: "open source" });               // $0.025, several platforms at once

Each method sends one GET, pays the 402 challenge with your wallet and resolves to the JSON answer; paged routes return next_cursor for the next call. client.callWithReceipt(path, params) also returns the settlement receipt (transaction hash).

Price guard

Before anything is signed, the client checks the payment requirement: Base USDC only, only to the service's address 0xCD673f7e1daD254347AEab6be0DEFe8b9C6b3A39, and never above the cap. By default each route is capped at its own listed price; createClient({ account, maxPriceUsd: 0.01 }) allows the $0.01 routes only. A refused call signs nothing and throws PriceGuardError. The client never retries a paid call on its own.

Errors and charges

A bad input is answered free with a 400; not found or no match is not charged. Errors throw DuoApiError with code, param, expected and requestId.

Routes

MethodRoutePriceMCP toolWhat it returns
client.blueskySearchGET /v1/bluesky/search$0.01bluesky_searchBluesky post search
client.blueskyPostsGET /v1/bluesky/posts$0.01bluesky_postsBluesky account feed
client.blueskyProfileGET /v1/bluesky/profile$0.01bluesky_profileBluesky profile
client.hackernewsSearchGET /v1/hackernews/search$0.01hackernews_searchHacker News search
client.hackernewsThreadGET /v1/hackernews/thread$0.01hackernews_threadHacker News thread
client.socialMentionsGET /v1/social/mentions$0.01social_mentionsSocial mentions and sentiment (aggregate)
client.xSearchGET /v1/x/search$0.02x_searchX (Twitter) post search
client.xPostsGET /v1/x/posts$0.02x_postsX (Twitter) user timeline
client.xProfileGET /v1/x/profile$0.02x_profileX (Twitter) profile
client.redditSearchGET /v1/reddit/search$0.02reddit_searchReddit post search
client.redditCommentsGET /v1/reddit/comments$0.02reddit_commentsReddit post comments
client.tiktokVideosGET /v1/tiktok/videos$0.02tiktok_videosTikTok account videos
client.tiktokSearchGET /v1/tiktok/search$0.02tiktok_searchTikTok video search
client.instagramProfileGET /v1/instagram/profile$0.02instagram_profileInstagram profile and posts
client.youtubeTranscriptGET /v1/youtube/transcript$0.02youtube_transcriptYouTube transcript
client.youtubeCommentsGET /v1/youtube/comments$0.02youtube_commentsYouTube video comments
client.threadsPostsGET /v1/threads/posts$0.02threads_postsThreads account posts
client.facebookAdsGET /v1/facebook/ads$0.02facebook_adsMeta Ad Library search
client.socialSearchGET /v1/social/search$0.025social_searchSocial search on X, Reddit and TikTok
client.socialAudienceGET /v1/social/audience$0.02social_audienceAudience and engagement stats
client.socialAccountsGET /v1/social/accounts$0.02social_accountsCreator and brand account search
client.linkedinCompanyGET /v1/linkedin/company$0.02linkedin_companyLinkedIn company page
client.socialPeopleGET /v1/social/people$0.02people_searchProfile search (TikTok, Instagram, Threads)
client.tiktokFollowersGET /v1/tiktok/followers$0.02tiktok_followersTikTok followers list
client.tiktokFollowingGET /v1/tiktok/following$0.02tiktok_followingTikTok following list
client.linkedinProfileGET /v1/linkedin/profile$0.02linkedin_profileLinkedIn profile

SOCIAL_ROUTES holds this table as data (path, MCP tool, price).

Responsible use

Answers are third parties' public data. Read the service's terms and privacy notice before you use them. Do not use the data to profile, target or train AI on individuals. Not affiliated with or endorsed by any platform.

MCP and plain HTTP

The same 26 tools are a paid MCP server at https://social.duoleads.com/mcp (Streamable HTTP; tools/list is free). Every route also works without this package: an unpaid request returns 402 Payment Required with a PAYMENT-REQUIRED header, and any x402 v2 client can pay it.

Links

Source

Source: github.com/hiesem/x402-social-media-data is a generated mirror of this package from the duo-data-utilities monorepo (packages/x402-social-media-data); issues are welcome in either repository.

License

MIT. See LICENSE.

Reviews

No reviews yet

Be the first to review this server!