📌Overview

Purpose: To provide a flexible and extensible server for accessing standardized data from various social platforms and on-chain sources.

Overview: Beyond MCP Server implements the Model Context Protocol, enabling structured access to data across multiple social media platforms and blockchain entities. Currently, it supports integration with Farcaster via the Neynar API, with plans for additional platforms like Twitter and Telegram.

Key Features:

MCP Compliant: Fully adheres to Model Context Protocol specifications, ensuring standardization across data sources.
Multi-Platform Support: Designed to handle multiple social media integrations, facilitating broader access to diverse data sets.
Extensibility: Simplifies the addition of new platform integrations, allowing developers to easily enhance functionality.
Optimized Formatting: Structures data outputs for efficient consumption by large language models (LLMs), improving data usability.
Flexible Transport Options: Accommodates both standard I/O and HTTP/SSE transports, enhancing compatibility with different use cases.

Beyond MCP Server

An extensible Model Context Protocol server providing standardized access to social platform data and on-chain data. Currently supports Farcaster (via Neynar API) with plans for Twitter and additional platforms like Telegram.

Features

MCP Compliant: Fully implements the Model Context Protocol specification.
Multi-Platform: Supports multiple social media platforms.
Extensible: Easy to add new platform providers.
Well-Formatted: Optimized context formatting for LLM consumption.
Flexible Transport: Supports 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)

Installation

Clone the repository

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

Install dependencies
```
npm install
```
Create a .env file from the template
```
cp .env.example .env
```
Configure your environment variables
- Required: Set NEYNAR_API_KEY in your .env file. Without a valid API key, Farcaster functionality will not work.

Build and start the server

npm run build
npm start  # For stdio mode (default)

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}/user/{userId}/content: Get user content.
social://{platform}/trending: Get trending topics.

Tools

search-content: Search for content on a social platform.
get-user-profile: Get a user's profile information.
get-user-balance: Get user's wallet balance (Farcaster only).
get-trending-topics: Get current trending topics.

Extending with New Providers

To add a new social platform provider:

Create a new directory in src/providers/.
Implement the ContentProvider interface.
Register the provider in the registry.

Example:

import { ContentProvider } from '../interfaces/provider';

export class MyPlatformProvider implements ContentProvider {
  public name = 'myplatform';
  public platform = 'myplatform';

  // Implement all required methods
}

Development

Running in Development Mode

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

Testing

npm test

Linting

npm run lint
npm run lint:fix

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a pull request.

Changelog

[1.0.0] - 2025-Mar-10

Initial release
Farcaster integration via Neynar API
MCP compliant server implementation

[1.0.1] - 2025-Mar-19

Added tools to fetch user profile with wallet address.

[1.0.2] - 2025-Mar-21

Added functionality to retrieve wallet balances via ID or username.

[1.0.3] - 2025-Mar-24

Added support to fetch bulk Farcaster channel information.