# Lens MCP Code

> Install the lens MCP server and register it with Claude Code Use when this capability is needed.

- Skill: `tomevault-io/lens-mcp-code` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/lens-mcp-code`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/lens-mcp-code/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/lens-mcp-code

---


Install the lens MCP server locally and register it with Claude Code so you can call `check_domain`, `check_domains`, and `lens_meta` tools directly from any conversation.

## Steps

### 1. Write server files

Create `~/.claude/mcp-servers/lens/` and write these two files using the Write tool. Expand `~` to the actual home directory path.

**`~/.claude/mcp-servers/lens/package.json`**:

```json
{
  "name": "lens-mcp",
  "version": "1.0.0",
  "type": "module",
  "description": "MCP server for lens.netray.info — unified domain health check",
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.0",
    "zod": "^3.0.0"
  }
}
```

**`~/.claude/mcp-servers/lens/server.mjs`**:

```javascript
#!/usr/bin/env node
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const BASE_URL = "https://lens.netray.info";

async function lensGet(path) {
  const res = await fetch(`${BASE_URL}${path}`, {
    headers: { Accept: "application/json" },
  });
  if (!res.ok) {
    const err = await res.json().catch(() => ({}));
    throw new Error(`${res.status}: ${err.error?.message ?? res.statusText}`);
  }
  return res.json();
}

const server = new McpServer({
  name: "lens",
  version: "1.0.0",
  description:
    "lens — unified domain health check (DNS, TLS, IP) at lens.netray.info",
});

server.tool(
  "check_domain",
  "Check DNS, TLS, and IP reputation for a single domain. Returns a structured health report with an A+–F grade, per-section scores, and hard-fail indicators.",
  { domain: z.string().describe("Domain name to check (e.g. example.com)") },
  async ({ domain }) => {
    const data = await lensGet(`/api/check/${encodeURIComponent(domain)}`);
    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
  }
);

server.tool(
  "check_domains",
  "Check up to 10 domains sequentially. Returns an array of health reports, one per domain. Errors on individual domains are captured per-entry rather than failing the whole batch.",
  {
    domains: z
      .array(z.string())
      .min(1)
      .max(10)
      .describe("List of domain names to check"),
  },
  async ({ domains }) => {
    const results = [];
    for (const domain of domains) {
      try {
        const data = await lensGet(`/api/check/${encodeURIComponent(domain)}`);
        results.push({ domain, ...data });
      } catch (err) {
        results.push({ domain, error: err.message });
      }
    }
    return {
      content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
    };
  }
);

server.tool(
  "lens_meta",
  "Get lens server metadata: version, configured backends, scoring profile name, and rate limit policy.",
  {},
  async () => {
    const data = await lensGet("/api/meta");
    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
  }
);

await server.connect(new StdioServerTransport());
```

### 2. Install dependencies

Run this in the server directory (requires Node.js ≥ 18):

```sh
cd ~/.claude/mcp-servers/lens && npm install
```

If `npm` is not found or the Node version is below 18, stop and tell the user: "Node.js ≥ 18 is required. Install it from https://nodejs.org and re-run this skill."

### 3. Register with Claude Code

```sh
claude mcp add lens -- node ~/.claude/mcp-servers/lens/server.mjs
```

### 4. Confirm

Tell the user:

> The lens MCP server is installed and registered. Restart Claude Code (or open a new session) to activate it.
>
> Available tools: `check_domain`, `check_domains`, `lens_meta`
>
> Example: "Check the domain health of example.com"

---
> Source: [netray-info/lens](https://github.com/netray-info/lens) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-16 -->