Connect AI apps

Two ways to connect

• Sign in (recommended). Add Searchlark's server URL to the app, sign in to Searchlark, and choose a workspace and an access level. No key or file. Works with Claude on the web, desktop and mobile, ChatGPT, Claude Code, Cursor and VS Code.
  https://searchlark.com/mcpCopy
• Run it on your computer with an API key. Download searchlark-mcp.mjs (needs Node.js 20 or later), create a key in Workspace settings, API and MCP, and point your app at the file. Use this for scripts, your own agents, and apps without remote servers. Download searchlark-mcp.mjs.

Who can connect, and what they can change

• During the free trial, connections are read-only: the app can look at sites, articles, keywords, AI visibility and site health, but not change anything.
• On Growth and Agency, owners, admins and editors can also allow changes: planning, writing, approving and publishing articles, and re-checking fixes. Viewers connect read-only.
• A signed-in connection acts as you, in one workspace. An API key acts for the whole workspace; only owners and admins create keys.
• Each connection or key may make 120 requests a minute.

Set up your app

{
  "mcpServers": {
    "searchlark": {
      "command": "node",
      "args": [
        "/path/to/searchlark-mcp.mjs"
      ],
      "env": {
        "SEARCHLARK_API_KEY": "sl_live_…",
        "SEARCHLARK_API_BASE": "https://searchlark.com"
      }
    }
  }
}

claude mcp add --transport http searchlark https://searchlark.com/mcp

claude mcp add --transport stdio --env SEARCHLARK_API_KEY=sl_live_… \
  --env SEARCHLARK_API_BASE=https://searchlark.com searchlark -- node /path/to/searchlark-mcp.mjs

{
  "mcpServers": {
    "searchlark": {
      "url": "https://searchlark.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "searchlark": {
      "command": "node",
      "args": [
        "/path/to/searchlark-mcp.mjs"
      ],
      "env": {
        "SEARCHLARK_API_KEY": "sl_live_…",
        "SEARCHLARK_API_BASE": "https://searchlark.com"
      }
    }
  }
}

{
  "servers": {
    "searchlark": {
      "type": "http",
      "url": "https://searchlark.com/mcp"
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "searchlark-key",
      "description": "Searchlark API key",
      "password": true
    }
  ],
  "servers": {
    "searchlark": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/path/to/searchlark-mcp.mjs"
      ],
      "env": {
        "SEARCHLARK_API_KEY": "${input:searchlark-key}",
        "SEARCHLARK_API_BASE": "https://searchlark.com"
      }
    }
  }
}

import os
from agents import Agent, Runner
from agents.mcp import MCPServerStdio

async with MCPServerStdio(params={
    "command": "node",
    "args": ["/path/to/searchlark-mcp.mjs"],
    "env": {"SEARCHLARK_API_KEY": os.environ["SEARCHLARK_API_KEY"],
            "SEARCHLARK_API_BASE": "https://searchlark.com"},
}) as searchlark:
    agent = Agent(name="SEO assistant", mcp_servers=[searchlark])
    result = await Runner.run(agent, "Which site health problems should I fix first?")
    print(result.final_output)

What the app can do

Every tool maps to one REST API operation, so the same permissions apply. Tools marked “changes” are hidden from read-only connections.

Prompts

• fix_health_problem: Fix one site health problem in your codebase, then re-check it. In Claude Code, type / and pick it from the list.
• fix_health_plan: Work through the site's health fix plan, most important first. In Claude Code, type / and pick it from the list.

Things to ask

• “Which site health problems should I fix first, and why?”
• “Plan an article on a topic from my keyword list, write it, show me the draft, and publish it if the fact check is clean.”
• “Which of my articles lost the most clicks this month?”
• “How often do AI assistants mention us compared with last month?”

Stay in control

• Choose read access unless the app needs to make changes. Articles still wait for your approval unless you switched on autopilot.
• Tool results can include text from your website and other sites. Treat what the app suggests as a draft, and check changes before you approve them.
• Disconnect an app or revoke a key at any time in Workspace settings, API and MCP. It stops working at once. Signed-in connections renew their access every hour and end after 30 days without use.
• The AI app you connect is your choice, and its maker's terms and privacy policy apply to what it receives from Searchlark.

If something doesn't work

• Asked to sign in again: the connection was disconnected, or you left the workspace. Connect again from the app.
• “plan_required”: the workspace's plan doesn't allow that call. During the trial, changes aren't available.
• “insufficient_scope”: the connection or key is read-only. Connect again and allow changes, or create a key with write access.
• The local server doesn't start: check node --version (20 or later) and the full path to searchlark-mcp.mjs.
• Developers: the API and MCP guide lists every endpoint and error, and the OpenAPI spec describes them for tool-calling frameworks. The server also publishes its OAuth metadata at /.well-known/oauth-authorization-server.