Meta XR Unity MCP Extension

This package extends the Unity MCP package (com.unity.ai.mcp), which is part of the Unity AI Suite (Beta Early Access), with additional Meta-specific tools.

With this package, you can use features specific to Meta XR development directly from your AI Agent. These include adding a camera rig, adding an interaction rig and interactors, and more. See the Tools section below for a comprehensive list.

Installation

Get access to Unity's AI Gateway by following the instructions on the Unity AI Gateway page.

In Unity, add the following packages using the Package Manager:

• Meta Core SDK (com.meta.xr.sdk.core): v78 or later
• Meta Interaction SDK (com.meta.xr.sdk.interaction.ovr): v78 or later
• Unity Assistant (com.unity.ai.assistant): Access to the Unity AI Gateway is required

Then, install this package in your project by using the following Git URL:

https://github.com/meta-quest/Unity-Mcp-Extensions.git

After installing this package, follow the instructions in the Unity MCP documentation on setup and usage.

Tools

This package contains the following MCP tools that perform specific actions or services:

Core SDK

• meta_add_camerarig: adds the camera rig required for VR and MR development
• meta_get_config_information: get information on location of configuration files and specific details on how to use them. This will help the AI agent better understand how to manipulate them.
• meta_update_android_manifest: updates the Android manifest, which is necessary after modifying certain settings in the configuration

Interaction SDK

• meta_add_canvas_interaction_poke: adds a poke interaction to a Canvas for UI interactions
• meta_add_canvas_interaction_ray: adds a ray interaction to a Canvas for distance UI interactions
• meta_add_distance_grabbable: sets up a GameObject with a distance grab interaction
• meta_add_grabbable: sets up a GameObject with a grab interaction
• meta_add_interactionrig: adds the comprehensive interaction rig required for Interaction SDK features
• meta_add_teleport_hotspot: places a teleport hotspot at the given world position
• meta_get_interactors_state: get the list of interactors from the interaction rigs with their instance ID and the current state enabled/disabled. With that information it's then possible for the AI agent to modify the state of the interactors.

Skill Importer

This package also includes an editor window for importing Meta XR skills — reusable instructions that guide an AI agent through Meta XR workflows — from the meta-quest/agentic-tools repository.

Open it from the menu: Meta ▸ MCP Extension ▸ Import Meta Skills...

• Skills with "unity" in the name are shown by default; toggle Show all skills for the rest.
• Pick a target with Import to: the Unity AI Assistant, or another agent (Claude, Codex, Copilot, Cursor, Gemini, OpenCode) written to that tool's skills folder. For the AI Assistant, choose Project Skills (Assets/MetaSkills) or User Skills.
• Already-installed and outdated skills are flagged. For the AI Assistant, each skill's allow/deny state is shown — use Open Preferences ▸ AI ▸ Skills to allow them.
• Auto-open on Editor launch (bottom of the window) controls whether it opens once per session: always, only when updates are available, or never.

License

This package is licensed under the Meta Platform Technologies SDK license.

Contribution

See CONTRIBUTING.md for information about how to contribute.