mcpField
M
marble-developer-api

marble-developer-api

github.com/worldlabsaiDevelopment93 installs
Repository

About marble-developer-api

A reference skill for developers working with the published World Labs / Marble Public API v1. It guides API explanations, integration code, client generation, and debugging using the API documentation and OpenAPI specification.

Key features

  1. 01Consult API and OpenAPI references
  2. 02Create API examples in several languages
  3. 03Explain world-generation request formats
  4. 04Generate or update clients from OpenAPI
  5. 05Debug authentication, uploads, and operations

Use cases

  1. 01Build integrations with Marble Public API v1
  2. 02Generate client code from the API specification
  3. 03Troubleshoot API key or validation errors
  4. 04Track generation operations and retrieve worlds

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/worldlabsai/marble-developer-api-skill --skill marble-developer-api

After installing, type/marble-developer-apiin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
api.md
openapi.yaml

Details

From the project README

World Labs API

Use this skill when the user is working with the published World Labs / Marble Public API v1.

Before answering API-contract questions or writing integration code, read references/api.md. For exact current endpoint and schema details, also inspect references/openapi.yaml.

Working Style

  • Authenticate with the WLT-Api-Key header, not bearer auth.
  • Treat API keys as secrets. Never print, commit, or log a real key.
  • Prefer explicit model names such as marble-1.1 or marble-1.1-plus.
  • Use media asset uploads for local image/video files before world generation.
  • Poll /marble/v1/operations/{operation_id} until done is true; fetch the world by world_id when the caller needs the latest world object.
  • Verify against references/openapi.yaml when generating clients or naming request fields.

Common Tasks

  • Write curl, Python, TypeScript, or SDK-style examples for world generation, operation polling, world retrieval, media asset upload, and pano depth-to-RGB.
  • Generate or update client code from the OpenAPI spec.
  • Explain request shapes for text, image, multi-image, video, media-asset, and URL-based world prompts.
  • Debug authentication, validation, media upload, operation status, and asset URL issues.

Comments

Markdown supported