MCP server

Connect AI agents to OneOver via the Model Context Protocol. The MCP server exposes the same Business API as tools — use your existing oo_live_ key.

Endpoint

Streamable HTTP

https://api.oneover.com/functions/v1/mcp

Transport: JSON-RPC 2.0 over HTTP. Auth: Authorization: Bearer oo_live_…

Tools

Tool	Scope	Description
`chat`	`chat`	Stateless chat completion
`generate_image`	`images`	Image from prompt
`generate_video`	`video`	Submit async video job
`check_video`	`video`	Poll video job status
`generate_audio`	`audio`	Speech or music
`list_models`	`usage`	Org model catalog
`get_usage`	`usage`	Balance or usage report

Video is async: call generate_video, then poll with check_video until status is complete or failed.

Cursor

Add to .cursor/mcp.json or Cursor Settings → MCP.

Cursor MCP config

{
  "mcpServers": {
    "oneover": {
      "url": "https://api.oneover.com/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer oo_live_YOUR_KEY"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS).

Claude Desktop config

{
  "mcpServers": {
    "oneover": {
      "url": "https://api.oneover.com/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer oo_live_YOUR_KEY"
      }
    }
  }
}

ChatGPT

If your ChatGPT plan supports custom MCP connectors, add the same URL and Authorization header in Settings → Connectors.

REST alternative

Prefer direct HTTP? See the OpenAPI spec or the markdown docs at /developers/quickstart.md.