ETHID

You can run and query the ETHID MCP Server to access the Ethereum Follow Protocol (EFP) API for social graph data tied to Ethereum addresses and ENS names. This server enables you to fetch follower data, profile information, tags, and various social graph insights with pagination, filters, and real-time options geared for AI consumption.

How to use

You interact with the ETHID MCP Server through an MCP client. Use the available tools to query follower counts, fetch followers or following lists, check relationships, and resolve ENS names. You can filter results by tags such as top8, friend, or family, and you can request fresh data when you need the most up-to-date information.

Key capabilities you will leverage include pagination for large datasets, bulk ENS reverse resolution, and search functionality within follower and following lists. You can also fetch profile data, view notifications, and access guidance tools for best practices and usage tips.

Practical usage patterns include: getting a follower count for an address or ENS name, listing who a given address follows (with optional tag filters), resolving a set of addresses to ENS names, and retrieving complete profile data for an address. Real-time data options allow you to bypass caches when you need fresh results.

How to install

Prerequisites: use a modern Node.js environment and your preferred MCP client.

1. Prepare the MCP configuration that points to the remote server provided by ETHID.

2. Create a configuration snippet with the MCP server entry shown below. This config uses a local runtime to invoke the remote MCP endpoint.

3. Run your MCP client with the prepared configuration. The exact command depends on your client, but you will reference the ETHID MCP Server as a standard MCP source.

Configuration example and commands

{
  "mcpServers": {
    "ethid_mcp": {
      "command": "npx",
      "args": ["mcp-remote", "https://ethid-mcp.efp.workers.dev/sse"]
    }
  }
}

Usage examples with a client

Get follower count for an ENS name or address: call the getFollowerCount tool with the target identifier.

List who a user follows with a tag filter: call the getFollowing tool with addressOrName and tags like ["top8"].

Resolve multiple addresses to ENS names: call fetchBulkAccounts with an addresses array.

Fetch complete profile information: call fetchAccount with an address or ENS name.

Additional operational notes

• Use the real-time data option to bypass caching when you need the latest state.

• Take advantage of pagination when querying large follower/following sets to manage throughput efficiently.

Available tools

getFollowerCount

Return the number of followers for a given address or ENS name.

getFollowers

Fetch the list of followers for a given address or ENS name, with optional pagination.

getFollowing

Fetch the list of accounts that a given address or ENS name is following, with optional pagination and tag filtering.

checkFollowing

Check whether a source address follows a target address and return the follow state.

checkFollower

Check whether a target address follows a source address.

fetchAccount

Retrieve complete profile data for an address or ENS name, including ENS records and avatar.

fetchProfileStats

Fetch statistics related to a profile, such as activity metrics.

fetchProfileLists

Retrieve lists associated with a profile, such as curated collections.

fetchProfileBadges

Get badges associated with a profile.

fetchProfileQRCode

Return a QR code representation for a profile.

fetchProfileFollowing

Fetch accounts that a profile is following with support for pagination and filters.

fetchProfileFollowers

Fetch accounts that follow a profile with pagination and filters.

fetchFollowingTags

Fetch tags associated with the accounts a profile is following.

fetchFollowerTags

Fetch tags associated with the followers of a profile.

fetchFollowState

Query the follow state between two accounts.

fetchNotifications

Retrieve notifications related to a profile.

fetchRecommendations

Fetch recommended profiles or actions for a given context.

fetchLeaderboard

Retrieve a leaderboard of top profiles based on defined criteria.

fetchListState

Fetch the state of named lists.

fetchListsForUser

Fetch lists associated with a particular user.

fetchPoapLink

Fetch a POAP link related to a profile or event.

fetchBulkAccounts

Bulk reverse resolution of addresses to ENS names.

searchContexts

Search documentation contexts to guide usage.

getBestPractices

Provide best practice guidance for using the MCP server.

getUsagePattern

Offer insights into typical usage patterns and optimization tips.

getToolGuidance

Give tool-specific guidance for effective usage.

getEfficiencyTips

Provide efficiency tips for querying and data handling.