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

# MCP Setup

> Configure Lexful to be used via the Model Context Protocol.

This page describes, at a high level, how to configure Lexful as an MCP integration.

<Callout type="warning">
  MCP support for Lexful is currently in <b>preview</b>. The core endpoint is stable, but client-specific setup flows may change and some integrations have not been fully tested yet.
</Callout>

The exact steps depend on your MCP host (for example, a chat interface, IDE, or desktop app), but they all point at the same Lexful MCP endpoint:

```text theme={null}
https://api.us.lexful.app/mcp/{YOUR_ACCOUNT_ID}
```

Replace `{YOUR_ACCOUNT_ID}` with your actual Lexful account ID.

## Setup steps

<Steps>
  <Step title="Locate your MCP configuration">
    Open the MCP configuration for your client. This might be:

    <ul>
      <li>A JSON config file (for example, a desktop app settings file).</li>
      <li>A settings panel where you can paste a JSON block.</li>
      <li>A workspace or user settings file in your IDE.</li>
    </ul>
  </Step>

  <Step title="Add the Lexful server entry">
    Add a <code>lexful</code> entry pointing at your MCP endpoint:

    ```json theme={null}
    {
      "mcpServers": {
        "lexful": {
          "url": "https://api.us.lexful.app/mcp/{YOUR_ACCOUNT_ID}"
        }
      }
    }
    ```
  </Step>

  <Step title="Complete the OAuth flow">
    After saving your configuration, reconnect or restart your client. On first connection it will open a browser window asking you to authorize Lexful.
    Approve the request to complete the setup.
  </Step>
</Steps>

See the **MCP Examples** page for concrete client-specific snippets.