# Romergo Builder and MCP

Romergo Builder is the authenticated workspace for creating, editing, validating, previewing, and publishing visual novels and interactive story quests. The Builder application itself is not a public crawl target. This guide is public so AI clients can understand how to connect safely.

## Connect an AI client

1. Sign in at https://builder.romergo.com/.
2. Open https://builder.romergo.com/mcp/connect for client-specific connection help.
3. Add the remote HTTP MCP endpoint: https://mcp.romergo.com/mcp
4. Complete the Romergo OAuth authorization shown by the client. The connection only grants access allowed by the signed-in account.

For clients that accept JSON MCP configuration:

```json
{
  "mcpServers": {
    "romergo": {
      "transport": "http",
      "url": "https://mcp.romergo.com/mcp"
    }
  }
}
```

OAuth metadata:

- Protected resource: https://mcp.romergo.com/.well-known/oauth-protected-resource/mcp
- Authorization server: https://api.romergo.com/.well-known/oauth-authorization-server

Do not paste access or refresh tokens into chat messages, prompts, project content, or source files.

## Start every authoring session

After authorization, call these read-only MCP tools first:

1. `romergo_get_authorization_context`
2. `romergo_get_capabilities`
3. `romergo_get_authoring_guide`

Use the returned capability and authorization information as the source of truth. Read the current project before editing it, validate changes, and read back persisted state. Ask for explicit user confirmation before publishing or making destructive changes.

## What MCP can help with

- Inspect the signed-in user's available projects and project structure.
- Create and edit project metadata, chapters, scenes, flow, variables, and supported media references.
- Validate project structure and publication readiness.
- Preview or publish only when the relevant tools and authorization are available.

MCP does not make private projects public and does not provide anonymous authoring access.

## Public quest discovery

- Main Romergo agent guide and live catalog: https://romergo.com/llms.txt
- Player library: https://player.romergo.com/
- Player agent guide: https://player.romergo.com/llms.txt
- Public catalog API: https://api.romergo.com/public/quests