MCP Server Setup

What is the KasLens MCP Server?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to connect to external tools and data sources. KasLens provides an MCP server that gives AI assistants real-time access to Kaspa blockchain data, market analytics, and insights.

Once connected, your AI assistant can:

Query live Kaspa market data (price, volume, market cap)
Access analytics and historical data
Retrieve token information and wallet analytics
Get AI-generated market summaries and daily pulse reports

MCP Server URL

https://kaspa-lens.com/mcp

This is the URL you will use when configuring your AI assistant to connect to KasLens.

Quick Setup

Select your AI client below to get the configuration snippet and setup steps. You will need a KasLens account to complete the OAuth login.

ChatGPT connects to MCP servers through Developer mode. Requires a Plus, Pro, Team, Business, Enterprise, or Education subscription and the web version.

Go to Settings > Apps > Advanced settings
Toggle Developer mode on
Click Create app and enter the server URL:

https://kaspa-lens.com/mcp

Start a new conversation, click the + menu, select Developer mode, and enable the KasLens app
Send a message — ChatGPT opens a browser window for you to log in with your KasLens account

View detailed setup guide →

OpenCode is an interactive CLI coding agent. Add the KasLens MCP server to your configuration:

~/.config/opencode/opencode.jsoncopencode.jsonc (project root)

{
  "mcpServers": {
    "kaslens": {
      "enabled": true,
      "type": "remote",
      "url": "https://kaspa-lens.com/mcp",
      "oauth": {}
    }
  }
}

Add the configuration above to your OpenCode config file
Start OpenCode — it will detect the server and open your browser for OAuth login
If the browser does not open, run: opencode mcp auth kaslens

View detailed setup guide →

Cursor supports MCP servers via its settings or a project config file:

.cursor/mcp.json

{
  "mcpServers": {
    "kaslens": {
      "type": "http",
      "url": "https://kaspa-lens.com/mcp"
    }
  }
}

Add the configuration to .cursor/mcp.json — or open Cursor Settings > Tools & MCP > + Add new MCP server (Type: HTTP)
Cursor will prompt you to complete the OAuth login flow in your browser
Once authenticated, KasLens tools will appear in the MCP tools list

Claude Desktop supports MCP servers through its configuration file:

~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kaslens": {
      "type": "http",
      "url": "https://kaspa-lens.com/mcp"
    }
  }
}

Add the configuration to your Claude Desktop config file
Save the file and restart Claude Desktop
Claude will detect the new server and prompt you to authenticate via OAuth in your browser

VS Code with GitHub Copilot supports MCP servers in agent mode:

.vscode/mcp.json

{
  "servers": {
    "kaslens": {
      "type": "http",
      "url": "https://kaspa-lens.com/mcp"
    }
  }
}

Add the configuration to .vscode/mcp.json — or run MCP: Add Server from the command palette (Ctrl+Shift+P / Cmd+Shift+P)
VS Code will open your browser for OAuth authentication when you start the server
Once connected, KasLens tools appear in the Copilot chat agent mode

Windsurf supports MCP servers through its configuration:

~/.codeium/windsurf/mcp_config.json%USERPROFILE%\.codeium\windsurf\mcp_config.json

{
  "mcpServers": {
    "kaslens": {
      "type": "http",
      "url": "https://kaspa-lens.com/mcp"
    }
  }
}

Add the configuration to your Windsurf MCP config file
Save the file and restart Windsurf
Windsurf will prompt you to complete the OAuth login flow in your browser

For any MCP-compatible client, add the KasLens server using the standard JSON configuration format with HTTP transport:

{
  "mcpServers": {
    "kaslens": {
      "type": "http",
      "url": "https://kaspa-lens.com/mcp"
    }
  }
}

Common config file locations

Claude Code~/.claude.json

Gemini CLI~/.gemini/settings.json

Codex CLI~/.codex/config.toml

Kiro~/.kiro/settings/mcp.json

Add the configuration to your client's MCP config file
Restart or reload the client
Complete the OAuth login flow when prompted — a browser window will open for you to log in with your KasLens account

Note: The KasLens MCP server uses OAuth 2.0 with Dynamic Client Registration. Your client must support remote MCP servers with OAuth authentication.

Prerequisites

Before you can connect an AI assistant to the KasLens MCP server, you need a verified KasLens account. The MCP server uses OAuth 2.0 authentication — your AI assistant will ask you to log in with your KasLens account when you first connect.

Step 1: Create an Account

Go to kaspa-lens.com/auth/register
Enter your email address and choose a password (at least 8 characters)
Agree to the Privacy Policy and Terms of Service
Click Create account

Step 2: Verify Your Email

After registration, you will receive a verification email from [email protected].

Important: The verification email may land in your spam or junk folder. Check there if you do not see it in your inbox within a few minutes. Some email providers (Gmail, Outlook, Yahoo) are particularly aggressive about filtering automated emails.

Click the verification link in the email to activate your account. The link expires after 24 hours. If it has expired, simply register again with the same email address to receive a new one.

How Authentication Works

When you add the KasLens MCP server to your AI assistant, the following happens:

Discovery — Your AI client fetches the MCP server metadata from https://kaspa-lens.com/mcp, which points it to the OAuth authorization server
Client Registration — If your AI client supports Dynamic Client Registration (RFC 7591), it automatically registers itself with the KasLens authorization server
Login — A browser window opens where you log in with your KasLens email and password
Authorization — You grant the AI client permission to access KasLens data on your behalf
Connected — The AI assistant can now query KasLens data. The session stays active until you revoke access or the token expires

Your password is never shared with the AI assistant. Authentication uses the industry-standard OAuth 2.0 Authorization Code flow with PKCE.

Supported Clients

Client	Type	Status
ChatGPT	Web app	Detailed guide
OpenCode	CLI agent	Detailed guide
Cursor	IDE	Quick setup above
Claude Desktop	Desktop app	Quick setup above
VS Code + Copilot	IDE	Quick setup above
Windsurf	IDE	Quick setup above
Any MCP-compatible client	Various	Use the "Other" tab above

All MCP-compatible clients can connect using the server URL and a standard JSON configuration. If your client is not listed, use the generic configuration in the Other tab.