Skip to main content
Glama

Lens Protocol MCP Server

by daoleno

Lens Protocol MCP Server

A Model Context Protocol (MCP) server that provides access to Lens Protocol data and functionality. This server enables AI tools to interact with the Lens Protocol ecosystem through standardized MCP interfaces.

Features

Tools (Actions)

  • fetch_account - Fetch Lens Protocol account/profile by address
  • fetch_posts - Fetch posts with optional filters (by author, pagination)
  • fetch_followers - Get followers of a specific account
  • fetch_following - Get accounts that a specific account follows
  • search_accounts - Search for profiles (limited in public mode)
  • search_posts - Search for posts (limited in public mode)
  • fetch_apps - Fetch Lens Protocol applications
  • fetch_groups - Fetch groups from the protocol
  • fetch_usernames - Fetch username information

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

Installation

bun install

Usage

Starting the Server

Local (stdio) Mode
bun start
Remote HTTP Mode
bun start:http # Or with custom port PORT=8080 bun start:http

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 mainnet
  • PORT: HTTP server port (default: 3000)

Example MCP Tool Calls

Fetch Account
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "fetch_account", "arguments": { "address": "0x1234567890123456789012345678901234567890" } } }
Fetch Posts
{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "fetch_posts", "arguments": { "pageSize": 5, "author": "0x1234567890123456789012345678901234567890" } } }
Fetch Followers
{ "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "fetch_followers", "arguments": { "account": "0x1234567890123456789012345678901234567890", "pageSize": 10 } } }

MCP Client Configuration

Local Server Configuration

Add this server to your MCP client configuration:

{ "mcpServers": { "lens-protocol": { "command": "bun", "args": ["index.ts"], "cwd": "/path/to/lens-mcp" } } }
Remote Server Configuration

For remote HTTP access:

{ "mcpServers": { "lens-protocol-remote": { "transport": { "type": "http", "url": "http://your-server.com:3000/mcp" } } } }

Development

Running in Development Mode

# Stdio mode bun dev # HTTP mode bun dev:http

Testing

# Run unit tests bun test # Run integration tests bun test:integration # Run all tests bun test:all

Docker Deployment

# Build and run with Docker docker build -f docker/Dockerfile -t lens-mcp . docker run -p 3000:3000 lens-mcp # Or use docker-compose docker-compose -f docker/docker-compose.yml up

Architecture

The server is built using:

  • @lens-protocol/client@canary - Official Lens Protocol TypeScript SDK
  • @modelcontextprotocol/sdk - MCP server implementation
  • Bun - Fast JavaScript runtime and package manager

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

  1. Fork the repository
  2. Create a feature branch
  3. Make changes
  4. Test with bun test.ts
  5. Submit a pull request

License

MIT License

-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. Features
    1. Tools (Actions)
    2. Resources (Data Access)
  2. Installation
    1. Usage
      1. Starting the Server
      2. Configuration
      3. Example MCP Tool Calls
      4. MCP Client Configuration
    2. Development
      1. Running in Development Mode
      2. Testing
      3. Docker Deployment
    3. Architecture
      1. Limitations
        1. Contributing
          1. License

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              Enables AI assistants to interact with Meilisearch via the Model Context Protocol, allowing comprehensive index, document, and search management through a standardized interface.
              Last updated -
              68
              0
              9
              MIT License
              • Apple
              • Linux
            • A
              security
              F
              license
              A
              quality
              Implements 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 -
              1
              133
              • Apple
              • Linux
            • A
              security
              A
              license
              A
              quality
              Enables AI assistants to interact with LinkedIn data through the Model Context Protocol, allowing profile searches, job discovery, messaging, and network analytics.
              Last updated -
              28
              55
              13
              MIT License
              • Apple
            • -
              security
              A
              license
              -
              quality
              Enables AI applications to interact with decentralized storage through a standardized Model Context Protocol interface, allowing file uploads, retrievals, and identity management.
              Last updated -
              12
              Apache 2.0
              • Linux
              • Apple

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/daoleno/lens-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server