Beyond MCP Server

Features

• 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

Supported Platforms

• Farcaster: Full implementation via Neynar API

• Twitter: Placeholder (not implemented)

Getting Started

Prerequisites

• Node.js 16+

• Neynar API key (for Farcaster access) https://neynar.com/

Installation

1. Clone the repository

1. Install dependencies

1. Create a .env file from the template

1. Configure your environment variables

2. Build and start the server

Using with Claude for Desktop

1. Build the server

1. Make sure your .env file is properly configured with your API keys

2. Add the server to your Claude Desktop configuration at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

1. Restart Claude for Desktop

MCP Capabilities

Resources

• 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)

• social://{platform}/wallet/{walletAddress}/profile - Get user profile by wallet address

• social://{platform}/user/{userId}/content - Get user content

• social://{platform}/thread/{threadId} - Get conversation thread

• social://{platform}/trending - Get trending topics

• social://{platform}/trending-feed - Get trending feed content with multi-provider support (Farcaster only)

• social://{platform}/channels/search - Search for channels on a platform (Farcaster only)

• social://{platform}/channels/bulk-search - Search for multiple channels in parallel (Farcaster only)

Tools

• 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)

• get-user-content - Get content from a specific user

• get-thread - Get a conversation thread

• get-trending-topics - Get current trending topics

• getTrendingFeed - Get trending feed with multi-provider support (Farcaster only)

• get-wallet-profile - Get profile based on wallet address

• search-channels - Search for channels on a platform (Farcaster only)

• search-bulk-channels - Search for multiple channels in parallel (Farcaster only)

Prompts

• 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

• explore-channels - Analyze and explore channels on a platform

• explore-bulk-channels - Analyze and compare multiple channels in parallel

Extending with New Providers

1. Create a new directory in src/providers/

2. Implement the ContentProvider interface

3. Register the provider in the registry

Development

Running in Development Mode

Testing

Linting

License

Contributing

Changelog

[1.0.0] - 2025-Mar-10

Added

• Initial release

• Farcaster integration via Neynar API

• MCP compliant server implementation

• Support for both stdio and HTTP modes

[1.0.1] - 2025-Mar-19

Added

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

• Added new tests

[1.0.2] - 2025-Mar-21

Added

• 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

[1.0.3] - 2025-Mar-24

Added

• Add support to fetch Single and Bulk farcaster channel information

Beyond MCP Server

Features

• 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

Supported Platforms

• Farcaster: Full implementation via Neynar API

• Twitter: Placeholder (not implemented)

Getting Started

Prerequisites

• Node.js 16+

• Neynar API key (for Farcaster access) https://neynar.com/

Installation

1. Clone the repository

1. Install dependencies

1. Create a .env file from the template

1. Configure your environment variables

2. Build and start the server

Using with Claude for Desktop

1. Build the server

1. Make sure your .env file is properly configured with your API keys

2. Add the server to your Claude Desktop configuration at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

1. Restart Claude for Desktop

MCP Capabilities

Resources

• 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)

• social://{platform}/wallet/{walletAddress}/profile - Get user profile by wallet address

• social://{platform}/user/{userId}/content - Get user content

• social://{platform}/thread/{threadId} - Get conversation thread

• social://{platform}/trending - Get trending topics

• social://{platform}/trending-feed - Get trending feed content with multi-provider support (Farcaster only)

• social://{platform}/channels/search - Search for channels on a platform (Farcaster only)

• social://{platform}/channels/bulk-search - Search for multiple channels in parallel (Farcaster only)

Tools

• 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)

• get-user-content - Get content from a specific user

• get-thread - Get a conversation thread

• get-trending-topics - Get current trending topics

• getTrendingFeed - Get trending feed with multi-provider support (Farcaster only)

• get-wallet-profile - Get profile based on wallet address

• search-channels - Search for channels on a platform (Farcaster only)

• search-bulk-channels - Search for multiple channels in parallel (Farcaster only)

Prompts

• 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

• explore-channels - Analyze and explore channels on a platform

• explore-bulk-channels - Analyze and compare multiple channels in parallel

Extending with New Providers

1. Create a new directory in src/providers/

2. Implement the ContentProvider interface

3. Register the provider in the registry

Development

Running in Development Mode

Testing

Linting

License

Contributing

Changelog

[1.0.0] - 2025-Mar-10

Added

• Initial release

• Farcaster integration via Neynar API

• MCP compliant server implementation

• Support for both stdio and HTTP modes

[1.0.1] - 2025-Mar-19

Added

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

• Added new tests

[1.0.2] - 2025-Mar-21

Added

• 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

[1.0.3] - 2025-Mar-24

Added

• Add support to fetch Single and Bulk farcaster channel information