> ## 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.

# Compatible Clients

> AI assistants and development tools that work with the Venturu MCP server.

## Supported MCP Clients

The Venturu MCP server uses the **Streamable HTTP** transport, which is supported by a growing number of AI assistants and development tools. Any client that implements the MCP specification can connect.

### AI Assistants

| Client             | Status    | Notes                                                         |
| ------------------ | --------- | ------------------------------------------------------------- |
| **Claude Desktop** | Supported | Full tool support with OAuth authentication                   |
| **ChatGPT**        | Supported | Enhanced experience with interactive listing and broker cards |
| **Claude (Web)**   | Supported | Works via the MCP integrations panel                          |

### Development Tools

| Client       | Status    | Notes                       |
| ------------ | --------- | --------------------------- |
| **Cursor**   | Supported | Available in Agent mode     |
| **Windsurf** | Supported | Remote MCP server support   |
| **VS Code**  | Supported | Via MCP extensions          |
| **Cline**    | Supported | Remote server configuration |

### Frameworks & Libraries

| Framework              | Transport       | Notes                                   |
| ---------------------- | --------------- | --------------------------------------- |
| **MCP TypeScript SDK** | Streamable HTTP | `@modelcontextprotocol/sdk`             |
| **MCP Python SDK**     | Streamable HTTP | `mcp` package                           |
| **mcp-handler**        | Streamable HTTP | Used to build the Venturu server itself |

## Client-Specific Features

### ChatGPT Apps SDK Widgets

When accessed from ChatGPT, the Venturu MCP server returns interactive HTML widgets for search results. Business listings and broker profiles are rendered as rich, visual cards directly in the conversation — with images, pricing, and direct links.

<Info>
  Widget resources are served automatically when the server detects a ChatGPT client. No additional configuration is needed.
</Info>

### Voice Agent Integration

The Venturu MCP server supports integration with voice AI platforms like **ElevenLabs Conversational AI**. A pre-registered OAuth client allows voice agents to authenticate and use all tools, including contact tools, on behalf of users.

## Building a Custom Client

If you're building your own MCP client, connect using these details:

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

### Discovery Endpoints

| Endpoint                        | URL                                                              |
| ------------------------------- | ---------------------------------------------------------------- |
| **OAuth Authorization Server**  | `https://www.venturu.com/.well-known/oauth-authorization-server` |
| **Protected Resource Metadata** | `https://www.venturu.com/.well-known/oauth-protected-resource`   |

### Authentication Flow

1. Discover endpoints via `.well-known/oauth-authorization-server`
2. Register your client via Dynamic Client Registration (`/api/oauth/mcp/register`)
3. Initiate OAuth 2.0 + PKCE authorization flow
4. Exchange authorization code for access and refresh tokens
5. Include the access token as a `Bearer` token in MCP requests

See the [Authentication](/mcp/authentication) page for full details.