Ads Lighthouse MCP server

What it is

The Model Context Protocol (MCP) is an open standard that lets AI assistants call tools. Our hosted server offers the same report and workspace operations as the API, limited to your account. They cover projects, keywords and saved checks, plus advertiser, Shopping, affiliate, policy, redirect and alert reports. Analytics adds chart aggregates and the project's active keyword count. Observations and related history rows are kept for three UTC calendar months.

Try questions such as: Who advertised on our brand terms in the US last week? Which advertisers use our affiliate IDs? Did anything change on mobile since Monday?

Some ads include metadata for a results-page or landing-page preview. New landing previews are built from saved HTML and may load static styles, images and fonts when the preview is generated, so those assets can differ from the original capture. Scripts and nested documents stay disabled, and a preview is not a full crawl. Shopping products can include image_app_url, which opens for a signed-in account member, and serp_url for current results. Downloading an image_url needs a REST API credential, because an MCP sign-in token cannot fetch REST files. MCP returns links and metadata, not image bytes or captured HTML.

Connect your assistant

claude mcp add --transport http ads-lighthouse https://adslighthouse.com/api/v1/mcp

{
  "servers": {
    "ads-lighthouse": {
      "type": "http",
      "url": "https://adslighthouse.com/api/v1/mcp"
    }
  }
}

{
  "mcpServers": {
    "ads-lighthouse": {
      "httpUrl": "https://adslighthouse.com/api/v1/mcp"
    }
  }
}

{
  "mcpServers": {
    "ads-lighthouse": {
      "url": "https://adslighthouse.com/api/v1/mcp"
    }
  }
}

Use an API key instead of signing in

On Scale plans and above, any client that can send headers can use an API key instead. Send Authorization: Bearer als_your_key with every request. A key acts for the whole account, so create a read-only key unless the assistant needs to make changes. On other plans, connect by signing in.

Ads Lighthouse API

Tools

Every tool that takes project_id accepts the project id, the brand domain or the exact project or brand name. Tools that change data need write access, and the assistant should ask you before using them.

Security

• When you approve the connection, you choose the account and whether the assistant may make changes. Disconnect any app in Settings > API and MCP.
• Access tokens expire after one hour and refresh tokens rotate on every use. A reused refresh token ends the connection.
• The assistant acts as you: if you leave the account, or the account no longer has an active plan or trial, its access ends too.
• Creating a project and starting an on-demand check use your plan's allowance and need an idempotency key, so a retried call never runs the checks twice.
• Assistants can misread data. Check important findings in the app, where each observation shows its full context.