# Viewmax developer resources

Viewmax exposes a remote Model Context Protocol server for agents and publishes OAuth discovery metadata, an OpenAPI description, and machine-readable agent files.

## Endpoints

- MCP server: `https://www.viewmax.io/api/mcp`
- ChatGPT MCP server: `https://www.viewmax.io/api/chatgpt-mcp`
- OAuth authorization server metadata: `https://www.viewmax.io/.well-known/oauth-authorization-server`
- OAuth protected resource metadata: `https://www.viewmax.io/.well-known/oauth-protected-resource`
- OpenAPI 3.1 document: `https://www.viewmax.io/openapi.json`
- Agent index: `https://www.viewmax.io/llms.txt`

## Authorization

Viewmax uses OAuth 2.1 authorization code flow with PKCE and dynamic client registration. Clients should discover the authorization server from the protected resource metadata and request only the scopes needed for the tools they intend to call.

## Permission scopes

- `media:upload`: Upload and import media into the Viewmax library.
- `image:generate`: Generate images with Viewmax.
- `video:generate`: Generate videos and ads with Viewmax.
- `voice:change`: Change the voice in existing audio or video.
- `voiceover:generate`: Generate spoken voiceovers from text.
- `audio:generate`: Generate music and other audio.
- `generation:read`: Read generation status, history, models, and credit information.

Identity scopes `openid`, `profile`, `email`, and `offline_access` support sign-in and refresh tokens. Tool handlers enforce the capability scopes above for each operation.

## Protocol

Send MCP Streamable HTTP requests to the MCP endpoint. The OpenAPI document describes transport and authorization discovery; MCP tool schemas are returned by the protocol's `tools/list` method after connection.