Connect Docs MCP

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

To find actual images, connect Images MCP. Docs MCP answers questions about using Lightdrift; it does not run image searches. Both connections can be installed together.

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

Codex
Claude Code
Cursor
Claude
Other

Add the documentation server:

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.

Run:

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.

Add this entry to .cursor/mcp.json for your project, or ~/.cursor/mcp.json for all projects:

{
  "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.

If custom connectors are available in your Claude account, open Settings → Connectors → Add custom connector. Name it Lightdrift Docs and paste this URL:

https://docs.lightdrift.ai/mcp

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

Add a remote Streamable HTTP server using the URL above. For clients that use a mcpServers configuration:

{
  "mcpServers": {
    "lightdrift-docs": {
      "url": "https://docs.lightdrift.ai/mcp"
    }
  }
}

Leave authentication and custom headers empty. Save, then reload the connection in your client.

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:

{
  "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 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 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 directly while it reconnects.

Next steps

Follow the REST quickstart with your agent.
Explore agent integration patterns.
Connect Images MCP to search for images directly.

Get started

Learn

Account

Core concepts

Before you connect

Choose your client

Check the connection

Available tools

Use both MCP connections

Troubleshooting

Next steps

​Before you connect

​Choose your client

​Check the connection

​Available tools

​Use both MCP connections

​Troubleshooting

​Next steps

Before you connect

Choose your client

Check the connection

Available tools

Use both MCP connections

Troubleshooting

Next steps