---
title: "seminara.online Model Context Protocol (MCP) Server Guide"
description: "Model Context Protocol (MCP) server guide for connecting Claude, Cursor, and autonomous agents with seminara.online, including tools and MCP Apps UI rendering."
canonical: "https://seminara.online/docs/mcp"
last-updated: "2026-08-23"
---

# seminara.online Model Context Protocol (MCP) Server Guide

> Model Context Protocol (MCP) server guide for connecting Claude, Cursor, and autonomous agents with seminara.online, including tools and MCP Apps UI rendering.

**Category:** API & Agents

Seminara (`https://seminara.online`) exposes a native **Model Context Protocol (MCP)** server over Streamable HTTP. This enables Claude, ChatGPT, Cursor, and autonomous agents to manage interactive presentations, inspect attendee analytics, and render in-agent interactive UI cards natively.

## Connection Details

- **Server URL**: `https://seminara.online/api/v1/mcp`
- **Alternative URL**: `https://seminara.online/api/mcp`
- **Standard Discovery Manifest**: `https://seminara.online/.well-known/mcp.json`
- **Transport**: Streamable HTTP / Server-Sent Events (SSE) & JSON-RPC 2.0
- **Protocol Version**: `2026-07-28` (and `2025-11-25`)

---

## Configuration

### 1. Claude Desktop / Cursor (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "seminara": {
      "command": "npx",
      "args": ["-y", "seminara-mcp"],
      "env": {
        "SEMINARA_API_KEY": "sk_live_your_api_key_here",
        "SEMINARA_BASE_URL": "https://seminara.online"
      }
    }
  }
}
```

### 2. Direct HTTP JSON-RPC 2.0
```http
POST /api/v1/mcp HTTP/1.1
Host: seminara.online
Authorization: Bearer sk_live_your_api_key_here
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}
```

---

## Available MCP Tools

| Tool Name | Description | UI Resource URI (`_meta.ui`) |
| :--- | :--- | :--- |
| `create_session` | Create an interactive presentation with slides, AI persona notes, and CTAs. | `ui://seminara.online/sessions/create` |
| `list_sessions` | List active, scheduled, or draft sessions for the host account. | `ui://seminara.online/sessions/list` |
| `get_session` | Fetch complete details, slides, and join link for a session. | `ui://seminara.online/sessions/preview` |
| `get_session_analytics` | Retrieve attendee engagement, questions asked, and duration metrics. | `ui://seminara.online/analytics` |
| `export_leads` | Export captured leads, contact details, and intent signals from a session. | `ui://seminara.online/leads` |

---

## MCP Apps Support (`@modelcontextprotocol/ext-apps`)

Seminara supports **MCP Apps**, enabling AI agents to render rich, interactive UI components directly within conversational interfaces using `ui://` resource URIs:

- `ui://seminara.online/sessions/create` — Interactive slide uploader and presentation customizer.
- `ui://seminara.online/sessions/preview` — Live interactive presentation preview card.
- `ui://seminara.online/analytics` — Real-time attendee dropoff and engagement chart.

To request a UI component, call `resources/read`:
```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "resources/read",
  "params": {
    "uri": "ui://seminara.online/sessions/create"
  }
}
```

---

## Frequently Asked Questions (FAQ)

**Q: Can I use Seminara MCP tools without an API key?**

A: Discovery methods (`server/discover`, `initialize`, and `resources/list`) can be probed without authentication. Calling execution tools (`create_session`, `export_leads`) requires a Bearer API Key.

**Q: Where can I test the MCP server?**

A: You can inspect the live discovery manifest at `https://seminara.online/.well-known/mcp.json` or query `GET https://seminara.online/api/v1/mcp`.
