Beyond MCP Server

An extensible Model Context Protocol server that provides standardized access to social platform data and onchain data. Currently supports Farcaster (via Neynar API) with placeholder for Twitter integration. More platforms like Telegram including onchain data will be added soon.

- MCP Compliant: Fully implements the Model Context Protocol specification
- Multi-Platform: Designed to support multiple social media platforms
- Extensible: Easy to add new platform providers
- Well-Formatted: Optimized context formatting for LLM consumption
- Flexible Transport: Supports both stdio and SSE/HTTP transports

- Farcaster: Full implementation via Neynar API
- Twitter: Placeholder (not implemented)

- Node.js 16+
- Neynar API key (for Farcaster access)https://neynar.com/

git clone https://github.com/yourusername/beyond-mcp-server.git cd beyond-mcp-server

cp .env.example .env # Edit .env with your API keys

- Required: SetNEYNAR_API_KEYin your .env file
- You can obtain a Neynar API key fromhttps://neynar.com/
- Without a valid API key, Farcaster functionality will not work

npm run build npm start # For stdio mode (default) # OR npm run start:http # For HTTP/SSE mode

{ "mcpServers": { "beyond-social": { "command": "/usr/local/bin/node", "args": [ "/full/path/to/beyond-mcp-server/dist/index.js", "--stdio" ] } } }

- Alternatively, you can pass the API key and other environment variables directly in the Claude Desktop configuration (recommended):

{ "mcpServers": { "beyond-social": { "command": "/usr/local/bin/node", "args": [ "/full/path/to/beyond-mcp-server/dist/index.js", "--stdio" ], "env": { "NEYNAR_API_KEY": "YOUR_API_KEY_HERE", "ENABLE_FARCASTER": "true", "ENABLE_TWITTER": "false" } } } }

- social://{platform}/{query}/search- Search content on a platform
- social://{platform}/user/{userId}/profile- Get user profile
- social://{platform}/wallet/{walletAddress}/profile- Get user profile by wallet address (Farcaster only)
- social://{platform}/user/{userId}/balance- Get user's wallet balance (Farcaster only)

- Accepts either FID (numeric) or username
- If username is provided, automatically converts to FID before fetching balance

- Supports providers: neynar (default), openrank, mbd
- Parameters: timeWindow (1h, 6h, 12h, 24h, 7d, 30d), limit

- Parameters: query, limit, cursor
- Returns channel details including name, description, follower count, and metadata

- Parameters: queries (array), limit, cursor
- Returns results for each query with channel details and pagination info

- search-content- Search for content on a social platform
- get-user-profile- Get a user's profile information
- get-user-profile-by-wallet- Get user profile using wallet address (Farcaster only)
- get-user-balance- Get user's wallet balance (Farcaster only)

- Accepts either FID (numeric) or username
- Automatically handles username to FID conversion

- Parameters: query, limit, cursor
- Returns detailed channel information including follower count and metadata

- Parameters: queries (array), limit, cursor
- Returns results for each query with channel details and pagination info

- analyze-thread- Analyze a social media thread
- summarize-user-activity- Summarize a user's activity
- explore-trending-topics- Explore trending topics on a platform
- analyze-search-results- Analyze search results for a query
- explore-trending-feed- Analyze trending feed content across different providers
- get-wallet-profile- Get and analyze user profile by wallet address
- check-user-balance- Analyze user's wallet balance and holdings

- Works with both FID and username inputs
- Handles automatic FID resolution for usernames

- Provides insights about channel popularity and content
- Helps discover relevant channels based on search criteria

- Efficiently searches and compares multiple channels
- Provides insights about channel relationships and trends
- Create a new directory insrc/providers/
- Implement theContentProviderinterface
- Register the provider in the registry

import { ContentProvider } from '../interfaces/provider'; export class MyPlatformProvider implements ContentProvider { public name = 'myplatform'; public platform = 'myplatform'; // Implement all required methods }

npm run dev # stdio mode npm run dev:http # HTTP mode

Contributions are welcome! Please feel free to submit a Pull Request.

All notable changes to this project will be documented in this file.

- Initial release
- Farcaster integration via Neynar API
- MCP compliant server implementation
- Support for both stdio and HTTP modes

- Added new tools and resource to fetch user profile with wallet address
- Added new tests

- Added functionality to retrieve wallet balances of Farcaster users via ID or username
- Implemented multi-provider support for trending feed content
- Enhanced updateUserProfile with additional user details
- Added comprehensive tests to ensure reliability and performance

- Add support to fetch Single and Bulk farcaster channel information

An MCP server for Bluesky that provides tools to interact with the ATProtocol.

MCP server for the GetXAPI Twitter / X data API. 44 endpoints across reads and writes. Bearer token auth.

Automate and manage interactions on a Facebook Page using the Facebook Graph API.

Integrates with the LinkedIn API, allowing interaction with your professional network and content.

A MCP server for LinkedIn REST API v2 that enables AI assistants to create, list, and delete posts, manage events, upload images, comment, and react—featuring OAuth 2.0 with session persistence, local post history tracking, and multiple automated tests

A Node.js service for interacting with the LnExchange API for spot trading.

A public MCP server that gives AI agents access to real UK carrier phone numbers for SMS verification. Agents can rent disposable or rental numbers, pay Lightning invoices, and read incoming SMS, all through standard MCP tool calls with no authentication required.

Access market data, manage accounts, and execute trades on the Upbit Cryptocurrency Exchange via its OpenAPI.

An MCP server for interacting with the Warpcast social network.

Interact with Warpcast accounts, enabling actions like posting casts and managing your profile.