Provides access to Lens Protocol data and functionality, enabling retrieval of account profiles, posts, followers/following relationships, search capabilities for accounts and posts, and information about applications and groups within the Lens Protocol ecosystem.
Lens Protocol MCP Server
A Model Context Protocol (MCP) server that provides agent-optimized access to Lens Protocol data and functionality.
🛠️ Available Tools
lens_search
When you need to find or discover anything on Lens Protocol
Find: Accounts, posts, usernames, apps, and groups
Natural Language: "crypto accounts", "DeFi posts", "popular apps"
Example:
lens_search(query="vitalik", type="accounts", show="concise")
lens_profile
When you want to learn everything about a Lens Protocol account
Comprehensive Analysis: Identity, social connections, influence, and activity with posts
Include Options:
basic
,social
,influence
,activity
(includes posts),network
Example:
lens_profile(who="0x...", include=["basic", "activity"], analyze="influence")
lens_content
When you want to understand how content performs and what people think about it
Content Analysis: Posts, reactions, comments, engagement metrics
Natural Queries: "reactions to this post", "popular posts by user"
Example:
lens_content(about="reactions", target="post_123", include=["likes", "comments"])
lens_ecosystem
When you want to explore the broader Lens Protocol ecosystem
Ecosystem Views: Trending content, popular applications, platform statistics
Community Insights: Apps, groups, ecosystem health, growth areas
Example:
lens_ecosystem(view="trending", timeframe="7d", show="detailed")
Resources (Data Access)
lens://account/{address} - Account/profile information
lens://post/{id} - Post/publication data
lens://app/{address} - Application information
lens://group/{address} - Group information
📋 Response Formats
Concise (Default)
Natural language summaries optimized for AI understanding:
Detailed
Summary + complete JSON data for full context:
Raw
Direct JSON output for programmatic use:
🎯 Usage Examples
Search for Accounts
Analyze Profile with Activity and Social Data
Understand Content Engagement
Explore Ecosystem Trends
Installation
Usage
Starting the Server
Local (stdio) Mode
Remote HTTP Mode
The server supports both stdio (for local use) and HTTP (for remote access) transports.
Configuration
Set environment variables:
LENS_ENVIRONMENT
: Set to "testnet" for testnet, defaults to mainnetPORT
: HTTP server port (default: 3000)
MCP Client Configuration
Local Server Configuration
Add this server to your MCP client configuration:
Remote Server Configuration
For remote HTTP access:
Development
Running in Development Mode
Testing
Docker Deployment
🏗️ Architecture & Design Principles
Built With
@lens-protocol/client@canary - Official Lens Protocol TypeScript SDK
@modelcontextprotocol/sdk - MCP server implementation
Bun - Fast JavaScript runtime and package manager
Design Principles
Workflow-Focused: Tools match natural task subdivisions
Context Efficient: Built-in token limits and smart pagination
Natural Language: Returns semantic summaries by default
Actionable Errors: Error messages include specific guidance
Multiple Formats: Choose between
concise
,detailed
, orraw
output
Limitations
Search functionality is limited in public client mode (requires authenticated session)
Some advanced features require authentication which is not implemented in this server
Rate limiting depends on Lens Protocol API limits
Contributing
Fork the repository
Create a feature branch
Make changes
Test with
bun test.ts
Submit a pull request
License
MIT License
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables AI tools to interact with the Lens Protocol decentralized social network ecosystem. Supports fetching profiles, posts, followers, searching content, and accessing social graph data through standardized MCP interfaces.
Related MCP Servers
- AsecurityAlicenseAqualityEnables AI assistants to interact with Meilisearch via the Model Context Protocol, allowing comprehensive index, document, and search management through a standardized interface.Last updated -6809MIT License
- AsecurityFlicenseAqualityImplements the Model Context Protocol (MCP) to provide AI models with a standardized interface for connecting to external data sources and tools like file systems, databases, or APIs.Last updated -1136
- AsecurityAlicenseAqualityEnables AI assistants to interact with LinkedIn data through the Model Context Protocol, allowing profile searches, job discovery, messaging, and network analytics.Last updated -284915MIT License
- -securityAlicense-qualityEnables AI applications to interact with decentralized storage through a standardized Model Context Protocol interface, allowing file uploads, retrievals, and identity management.Last updated -12Apache 2.0