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

# Connect Cursor

> Add the Metal MCP server to Cursor.

Connect Cursor to the Metal MCP server to use your firm's data directly in the Cursor agent.

## Prerequisites

* An organization admin has enabled MCP (see [overview](/mcp/overview#prerequisites)).
* A recent version of Cursor that supports remote MCP servers.

## Add the server

<Tabs>
  <Tab title="Settings UI">
    <Steps>
      <Step title="Open MCP settings">
        Go to **Cursor Settings → MCP & Integrations**, then click **New MCP server** (or **Add custom MCP**).
      </Step>

      <Step title="Add the Metal server">
        Add an entry pointing at the Metal server URL:

        ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
        {
          "mcpServers": {
            "metal": {
              "url": "https://mcp.metal.ai/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Authenticate">
        Cursor opens a browser window to sign in with your Metal account. Approve access, and choose an organization if prompted.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Config file">
    Add Metal to your Cursor MCP config. Use `~/.cursor/mcp.json` for all projects, or `.cursor/mcp.json` in a project root.

    ```json .cursor/mcp.json theme={"theme":{"light":"github-light","dark":"github-dark"}}
    {
      "mcpServers": {
        "metal": {
          "url": "https://mcp.metal.ai/mcp"
        }
      }
    }
    ```

    Reopen Cursor, then complete the browser sign-in when prompted.
  </Tab>
</Tabs>

## Verify

Open the Cursor agent and confirm a **metal** server appears in the MCP tools list with a green/connected status. Ask the agent something that uses your data, for example:

> Search Metal for industrial automation companies and summarize the top three.

## Troubleshooting

* **Server shows as disconnected**: make sure an admin enabled MCP under **Settings → Organization → API & MCP Access**, then toggle the server off and on in Cursor to re-run sign-in.
* **No tools listed**: confirm the URL is exactly `https://mcp.metal.ai/mcp` (including the `/mcp` path).

See the [tools reference](/mcp/tools-reference) for parameters and response examples, and the [overview](/mcp/overview) for shared troubleshooting.