Portamora

Official8 tools

by portamora

Discover atmospheric 3D worlds, read controls, and build and publish authorized environments.

app.portamora/mcp (Model Context Protocol) Server

The app.portamora/mcp MCP server provides tools related to exploring 3D worlds, building atmospheric environments, and publishing those environments using a Portamora account. It is positioned as an interface for working with Portamora content within an MCP-enabled workflow.

🛠️ Key Features

Supports exploring 3D worlds
Enables building atmospheric environments
Enables publishing via a Portamora account

🚀 Use Cases

Explore 3D worlds through an MCP-connected setup
Create and iterate on atmospheric environments
Publish finished environments under a Portamora account

⚡ Developer Benefits

Integrates Portamora 3D world creation and publishing concepts into MCP workflows
Uses Portamora account context for publishing

⚠️ Limitations

No tool list, configuration details, or technical integration specifics are provided in the available source data

Captured live from the server via tools/list.

search_worlds

Browse and search published worlds. Sort by newest, liked, or trending. The days filter accepts 1, 7 (API default), or 30 UTC calendar days including today, or all for any sort. Newest filters publication date unless days=all or creator is specified. Liked ranks period likes, or lifetime likes when days=all. Trending ranks period activity, or lifetime plays and likes when days=all, with publication-age decay in both cases. Older worlds may appear in activity rankings. The Explore website defaults to liked/all; API defaults remain newest/7. Search text can include exact #tags; custom tags are supported without a fixed vocabulary. Liked and trending require the community flag. Follow nextCursor with unchanged filters until null. Drafts and offline worlds are excluded. Public; no authentication is required.

Parameters7

q	string	optional
sort	string	optional
days	integer \| string	optional
tag	string	optional	One to 32 tag characters; optional leading #, surrounding whitespace, and uppercase letters are normalized.
creator	string	optional	An existing creator handle; lookup ignores case.
limit	integer	optional
cursor	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 200,
      "default": ""
    },
    "sort": {
      "type": "string",
      "enum": [
        "newest",
        "liked",
        "trending"
      ],
      "default": "newest"
    },
    "days": {
      "type": [
        "integer",
        "string"
      ],
      "enum": [
        1,
        7,
        30,
        "all"
      ],
      "default": 7
    },
    "tag": {
      "type": "string",
      "pattern": "^\\s*#?[A-Za-z0-9][A-Za-z0-9_-]{0,31}\\s*$",
      "description": "One to 32 tag characters; optional leading #, surrounding whitespace, and uppercase letters are normalized."
    },
    "creator": {
      "type": "string",
      "minLength": 3,
      "maxLength": 30,
      "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])$",
      "description": "An existing creator handle; lookup ignores case."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "default": 24
    },
    "cursor": {
      "type": "string",
      "maxLength": 1024
    }
  },
  "required": [],
  "additionalProperties": false
}

get_world

Read a public world page. Offline and removed worlds retain a notice; drafts are not exposed.

Parameters1

worldId

string

required

Case-sensitive world identifier with 10 safe-alphabet characters after the prefix.

Raw schema

{
  "type": "object",
  "properties": {
    "worldId": {
      "type": "string",
      "minLength": 16,
      "maxLength": 16,
      "pattern": "^world_[6789BCDFGHJKLMNPQRTWbcdfghjkmnpqrtwz]{10}$",
      "description": "Case-sensitive world identifier with 10 safe-alphabet characters after the prefix."
    }
  },
  "required": [
    "worldId"
  ],
  "additionalProperties": false
}

get_version

Read the current ready version of a published world. Unpublished versions are not exposed.

Parameters1

versionId

string

required

Case-sensitive version identifier with 10 safe-alphabet characters after the prefix.

Raw schema

{
  "type": "object",
  "properties": {
    "versionId": {
      "type": "string",
      "minLength": 18,
      "maxLength": 18,
      "pattern": "^version_[6789BCDFGHJKLMNPQRTWbcdfghjkmnpqrtwz]{10}$",
      "description": "Case-sensitive version identifier with 10 safe-alphabet characters after the prefix."
    }
  },
  "required": [
    "versionId"
  ],
  "additionalProperties": false
}

get_creator

Read an active creator profile. Email addresses, roles and account state are never exposed.

Parameters1

handle

string

required

An existing creator handle; lookup ignores case.

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 3,
      "maxLength": 30,
      "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])$",
      "description": "An existing creator handle; lookup ignores case."
    }
  },
  "required": [
    "handle"
  ],
  "additionalProperties": false
}

get_community

Read server-evaluated community and play-counting flags. Personal state is returned by me.get. Lists use cursor pagination.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

list_comments

Read plain-text comments, newest first, with deletion placeholders. Viewer controls are private; no-store. Lists use cursor pagination.

Parameters3

worldId	string	required	Case-sensitive world identifier with 10 safe-alphabet characters after the prefix.
limit	integer	optional
cursor	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "worldId": {
      "type": "string",
      "minLength": 16,
      "maxLength": 16,
      "pattern": "^world_[6789BCDFGHJKLMNPQRTWbcdfghjkmnpqrtwz]{10}$",
      "description": "Case-sensitive world identifier with 10 safe-alphabet characters after the prefix."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "default": 24
    },
    "cursor": {
      "type": "string",
      "maxLength": 1024
    }
  },
  "required": [
    "worldId"
  ],
  "additionalProperties": false
}

read_guide

Read an official Portamora guide, policy, agent discovery file, or OpenAPI specification. Start with worlds before building and workflows before uploading.

Parameters1

guide

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "guide": {
      "type": "string",
      "enum": [
        "agents",
        "worlds",
        "api",
        "workflows",
        "mcp",
        "terms",
        "privacy",
        "discovery",
        "openapi"
      ]
    }
  },
  "required": [
    "guide"
  ],
  "additionalProperties": false
}

get_starter

Get the editable starter ZIP and the build guide. Download and build it in your own workspace; the MCP server does not execute world code.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Install

Tools (8)

search_worldsget_worldget_versionget_creatorget_communitylist_commentsread_guideget_starter

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://portamora.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://portamora.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

app.portamora/mcp (Model Context Protocol) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_worlds

get_world

get_version

get_creator

get_community

list_comments

read_guide

get_starter

Install

Remote endpoint

Related servers