> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lightdrift.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Docs MCP

> Give your agent access to Lightdrift documentation, API details, and integration guidance. No account or API key required.

Docs MCP lets your agent search and read Lightdrift documentation while you work. Use it to look up authentication, request parameters, search filters, and API response fields. This is the same connection available under **Learn → Connect Docs MCP** in the dashboard.

| Connection     | Details                              |
| -------------- | ------------------------------------ |
| Server URL     | `https://docs.lightdrift.ai/mcp`     |
| Transport      | Streamable HTTP                      |
| Authentication | None — public documentation          |
| Pricing        | No Lightdrift search credit required |

<Tip>
  To find actual images, connect [Images MCP](/guides/images-mcp). Docs MCP answers questions about using Lightdrift; it does not run image searches. Both connections can be installed together.
</Tip>

## Before you connect

Use a client that supports remote MCP over Streamable HTTP. You do not need a Lightdrift account, API key, or OAuth login for this server.

## Choose your client

<Tabs>
  <Tab title="Codex">
    Add the documentation server:

    ```bash theme={null}
    codex mcp add lightdrift-docs --url https://docs.lightdrift.ai/mcp
    ```

    Return to your Codex session and enable the server if prompted. No `codex mcp login` step is needed for Docs MCP. If the tools do not appear, start a new session after adding the server.
  </Tab>

  <Tab title="Claude Code">
    Run:

    ```bash theme={null}
    claude mcp add --transport http lightdrift-docs https://docs.lightdrift.ai/mcp
    ```

    In Claude Code, open `/mcp` and check that **lightdrift-docs** is connected. No authentication step is needed.
  </Tab>

  <Tab title="Cursor">
    Add this entry to `.cursor/mcp.json` for your project, or `~/.cursor/mcp.json` for all projects:

    ```json theme={null}
    {
      "mcpServers": {
        "lightdrift-docs": {
          "url": "https://docs.lightdrift.ai/mcp"
        }
      }
    }
    ```

    If the file already contains servers, add **lightdrift-docs** inside the existing `mcpServers` object. Open Cursor's MCP settings and enable the connection. No headers or sign-in are required.
  </Tab>

  <Tab title="Claude">
    If custom connectors are available in your Claude account, open **Settings → Connectors → Add custom connector**. Name it **Lightdrift Docs** and paste this URL:

    ```text theme={null}
    https://docs.lightdrift.ai/mcp
    ```

    Save the connector and enable it for your conversation. Docs MCP does not require Lightdrift sign-in.
  </Tab>

  <Tab title="Other">
    Add a remote Streamable HTTP server using the URL above. For clients that use a `mcpServers` configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "lightdrift-docs": {
          "url": "https://docs.lightdrift.ai/mcp"
        }
      }
    }
    ```

    Leave authentication and custom headers empty. Save, then reload the connection in your client.
  </Tab>
</Tabs>

## Check the connection

Look for **lightdrift-docs** in your client's MCP tools list, then ask:

> Use Lightdrift Docs to explain how I authenticate a REST search and filter for landscape images that allow commercial use. Link to the relevant documentation.

The agent should return an explanation with documentation links. This does not run an image search or spend Lightdrift credit.

## Available tools

| Tool                               | What it does                                                                                                                                                          |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `search_lightdrift`                | Searches the documentation with a natural-language query and returns relevant content and page links.                                                                 |
| `query_docs_filesystem_lightdrift` | Reads and searches documentation files and the OpenAPI specification through a virtual, read-only documentation filesystem. It does not access your computer's files. |
| `submit_feedback`                  | Sends feedback about a documentation page. Ask your agent to use it only when you want to submit feedback.                                                            |

Tool names can appear with a client-specific prefix. Start with documentation search; your agent can read the relevant files when it needs more detail.

## Use both MCP connections

Keep **lightdrift** for image tools and **lightdrift-docs** for documentation. They use different URLs and authentication settings. For example, a client using JSON configuration can include both:

```json theme={null}
{
  "mcpServers": {
    "lightdrift": {
      "url": "https://lightdrift.ai/mcp"
    },
    "lightdrift-docs": {
      "url": "https://docs.lightdrift.ai/mcp"
    }
  }
}
```

Complete sign-in for **lightdrift** only. The [Images MCP guide](/guides/images-mcp) explains authentication and search pricing.

## Troubleshooting

| What happened                                       | What to do                                                                                                                       |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| No documentation tools appear                       | Check the URL, enable the server, and reload the connection or restart the client. Confirm remote Streamable HTTP is supported.  |
| The client asks for a Lightdrift account or API key | Check that the URL is `https://docs.lightdrift.ai/mcp`. Remove image-server authentication headers from this connection.         |
| The agent returns documentation instead of images   | That is the purpose of Docs MCP. Add [Images MCP](/guides/images-mcp) to search the image library.                               |
| The agent answers without consulting the docs       | Ask it explicitly to use **lightdrift-docs** and cite the pages it reads. Check that the tools are enabled for the conversation. |
| The connection temporarily fails                    | Retry the connection. You can also read the [documentation](/index) directly while it reconnects.                                |

## Next steps

* Follow the [REST quickstart](/quickstart) with your agent.
* Explore [agent integration patterns](/guides/agents).
* Connect [Images MCP](/guides/images-mcp) to search for images directly.