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

# Quickstart

> Connect to the Venturu MCP server from your AI client in under a minute.

## Connect in Seconds

The Venturu MCP server uses **Streamable HTTP** transport, which means most modern MCP clients can connect with just a URL — no local installation, no API keys, no configuration files.

```
https://www.venturu.com/mcp
```

## Setup by Client

<Tabs>
  <Tab title="Claude Desktop">
    1. Open **Claude Desktop** and go to **Settings** > **Developer** > **Edit Config**
    2. Add the Venturu server to your `claude_desktop_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "venturu": {
          "url": "https://www.venturu.com/mcp"
        }
      }
    }
    ```

    3. Save the file and **restart Claude Desktop**
    4. You should see the Venturu tools appear in the tools menu (hammer icon)
  </Tab>

  <Tab title="ChatGPT">
    ChatGPT supports MCP servers natively. The Venturu server is available as a remote connection:

    1. Open a new conversation in **ChatGPT**
    2. Click the **paperclip icon** and select **Connect to MCP Server**
    3. Enter the server URL: `https://www.venturu.com/mcp`
    4. The Venturu tools will appear in the conversation

    <Info>
      ChatGPT users get an enhanced experience with interactive listing and broker cards rendered directly in the chat.
    </Info>
  </Tab>

  <Tab title="Cursor">
    1. Open **Cursor Settings** > **MCP**
    2. Click **Add new MCP server**
    3. Set the type to **streamable-http** and enter:

    ```json theme={null}
    {
      "mcpServers": {
        "venturu": {
          "url": "https://www.venturu.com/mcp"
        }
      }
    }
    ```

    4. The Venturu tools will be available in Agent mode
  </Tab>

  <Tab title="Windsurf">
    1. Open the **Windsurf** MCP settings
    2. Add a new remote MCP server with the URL:

    ```
    https://www.venturu.com/mcp
    ```

    3. Save and the tools will be available in your AI conversations
  </Tab>

  <Tab title="Other Clients">
    Any client that supports the **Streamable HTTP** MCP transport can connect. Use the following details:

    | Property      | Value                          |
    | ------------- | ------------------------------ |
    | **URL**       | `https://www.venturu.com/mcp`  |
    | **Transport** | Streamable HTTP                |
    | **Auth**      | Optional — OAuth 2.0 with PKCE |

    If your client supports `server.json` manifests, point it to:

    ```json theme={null}
    {
      "name": "com.venturu/mcp-server",
      "remotes": [
        {
          "type": "streamable-http",
          "url": "https://www.venturu.com/mcp"
        }
      ]
    }
    ```
  </Tab>
</Tabs>

## Verify the Connection

Once connected, try a simple prompt to confirm everything is working:

<CodeGroup>
  ```txt title="Try This Prompt" theme={null}
  Search for restaurants for sale in Miami under $500,000
  ```
</CodeGroup>

The AI should call the `search_businesses` tool and return a list of matching business listings from Venturu.

<Check>
  If you see business results, you're connected. No API key needed for search tools.
</Check>

## Optional: Authenticate for Full Access

Search and detail tools work without authentication. To use **contact tools** (sending messages to brokers and sellers), you'll need to authenticate with your Venturu account.

When you attempt to use a tool like `contact_broker`, your MCP client will walk you through an OAuth login flow — just approve the connection with your Venturu credentials.

<Card title="Learn About Authentication" icon="lock" href="./authentication">
  Details on the OAuth 2.0 + PKCE flow and what each scope provides.
</Card>

## Next Steps

<CardGroup cols={2}>
  <Card title="Explore All Tools" icon="wrench" href="./tools/index">
    See the full reference for all 9 available tools.
  </Card>

  <Card title="Rate Limits" icon="gauge" href="./rate-limiting">
    Understand the request limits for anonymous and authenticated usage.
  </Card>
</CardGroup>
