home / mcp / beyond mcp server

Beyond MCP Server

An Extensible Model Context Protocol (MCP) server

Installation

Add the following to your MCP client configuration file.

Configuration

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

Beyond MCP Server is an extensible MCP server that offers standardized access to social platform data and onchain data through multiple providers. It is designed to be easily extended to support new platforms while delivering well-formatted context for downstream clients.

How to use

You run Beyond MCP Server as an MCP endpoint that your MCP clients can connect to for social platform and onchain data. Start the server in stdio mode for local use or HTTP/SSE mode if you want to expose the endpoint over HTTP. The server exposes a collection of resources and tools you can invoke through your MCP client to search content, fetch profiles, read threads, and analyze trends.

How to install

Prerequisites: Node.js 16+ and an API key for Neynar if you plan to access Farcaster data.

1. Clone the project directory and navigate into it.

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

2. Install dependencies.

npm install

3. Create a configuration file from the template and edit it with your keys.

cp .env.example .env
```

```text
Edit the .env file to include your Neynar API key and any other required credentials.

4. Build and start the server. You can run in stdio mode (default) or in HTTP/SSE mode.

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

Configuration and runtimes

The server can be run in stdio or HTTP mode. When you start in stdio mode, the server runs as a local process and communicates over standard input/output. In HTTP mode, it exposes an HTTP/SSE endpoint for remote clients. You can configure which providers are enabled via environment variables. The Neynar API key enables Farcaster access, while other providers can be toggled on or off as needed.

Important environment variables shown in examples include NEYNAR_API_KEY for Farcaster access, ENABLE_FARCASTER to enable Farcaster features, and ENABLE_TWITTER to enable Twitter features (placeholder in this version). Use a .env file or set variables in your environment before starting the server.

MCP command configurations

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

Available tools

search-content

Search for content on a social platform using the MCP endpoint.

get-user-profile

Fetch a user's profile information from a platform.

get-user-profile-by-wallet

Retrieve a user profile using a wallet address (Farcaster feature).

get-user-balance

Get a user's wallet balance using either FID or username with automatic resolution.

get-user-content

Retrieve content posted by a specific user.

get-thread

Fetch a conversation thread by threadId.

get-trending-topics

Obtain current trending topics on a platform.

getTrendingFeed

Get trending feed content with multi-provider support (Farcaster only).

get-wallet-profile

Get a profile based on a wallet address.

search-channels

Search for channels on a platform (Farcaster only).

search-bulk-channels

Search for multiple channels in parallel (Farcaster only).

analyze-thread

Analyze a social media thread for insights.

summarize-user-activity

Summarize a user's activity across a platform.

explore-trending-topics

Explore trending topics on a platform.

explore-trending-feed

Analyze trending feed content across providers.

get-wallet-profile

Retrieve and analyze user profile by wallet address.

check-user-balance

Analyze a user's wallet balance and holdings (FID or username).

explore-channels

Explore channels and provide insights about channel popularity.

explore-bulk-channels

Analyze and compare multiple channels in parallel.