search-contentLABSCO SUMMARY
Farcaster is the implemented platform; Twitter is scaffolding.
Everything usable runs through Neynar, including the parts that make this more than a feed reader — profile lookup by wallet address, on-chain balances, and a trending feed you can compare across three different ranking providers. The bulk channel search is the piece to remember: several queries in parallel with pagination, instead of one call per channel.
What it is
A social-data server with a provider architecture. Farcaster is fully implemented through the Neynar API, including wallet-based profile lookup and balances; a Twitter provider exists as a placeholder.
What you get
search-contentacross a platform,get-user-contentfor one account,get-threadfor a whole conversation- Profiles from either direction —
get-user-profile,get-user-profile-by-wallet,get-wallet-profile get-user-balance— a user's wallet balance, taking an FID or a username and resolving the username itself- Trending —
get-trending-topics, andgetTrendingFeedacross the neynar, openrank and mbd providers with time windows from 1h to 30d - Channels —
search-channels, andsearch-bulk-channelswhich runs several queries in parallel and returns follower counts and metadata with pagination - The same data as
social://resources, plus prompts such asanalyze-thread,summarize-user-activityandexplore-trending-feed
Requirements
Node.js 16+ and a Neynar API key in NEYNAR_API_KEY — without a valid key the Farcaster tools do not work. npm install, npm run build, then npm start for stdio or npm run start:http for HTTP/SSE. ENABLE_FARCASTER and ENABLE_TWITTER choose which providers load.
Setup effort
Build from source — git clone https://github.com/Beyond-Network-AI/beyond-mcp-server.git
USE CASES
Understanding a conversation you were linked into
Pull the whole thread and let the model summarise the argument rather than the last reply.
Working out who is behind a wallet
Look up the profile from a wallet address, and read the balance from either the FID or the username.
Seeing what is actually trending, not just what one ranker says
Compare the trending feed across neynar, openrank and mbd over the same time window.
Finding the channels worth following
Search several candidate topics in one parallel call and compare follower counts and metadata side by side.
11 tools
Listed in project docs. Your client may show a different list.
get-user-profileget-user-profile-by-walletget-user-balanceget-user-contentget-threadget-trending-topicsgetTrendingFeedget-wallet-profilesearch-channelssearch-bulk-channelsBEFORE YOU INSTALL
What to know first
Tools you get
11 tools named in the project's documentation.
Requires
- Node.js 16+
- NEYNAR_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
Clone the repository
git clone https://github.com/Beyond-Network-AI/beyond-mcp-server.git
cd beyond-mcp-serverInstall dependencies
npm installCreate a .env file from the template
cp .env.example .envBuild and start the server
npm run buildMCP Clients
Claude Desktop
{
"mcpServers": {
"beyond-social": {
"command": "/usr/local/bin/node",
"args": [
"<YOUR_PATH_TO_BEYOND_MCP_SERVER>/dist/index.js",
"--stdio"
],
"env": {
"NEYNAR_API_KEY": "<YOUR_NEYNAR_API_KEY>",
"ENABLE_FARCASTER": "true",
"ENABLE_TWITTER": "false"
}
}
}
}