Skip to main content
Glama
teleportxr

teleport-mcp

by teleportxr

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TELEPORTD_PATHNoPath to the teleportd binary. Searched first, before the build trees and PATH.
TELEPORT_SERVICE_PORTNoControl port. Default 10510.10510
TELEPORT_MCP_NO_AUTOSTARTNoSet to '1' to require a service that is already running (systemd, launchd, a terminal).

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
teleport_overviewA

Where am I: the service version, every open connection, and the current identity. Start here — one call answers whether the service is up and what it is already doing.

teleport_connectA

Open a connection to a Teleport server and return its id. The attempt is ASYNCHRONOUS: this returns as soon as it is initiated, not when it succeeds. Poll teleport_connection_status until state is CONNECTED. The connection outlives this conversation — it is still there in a later session.

teleport_list_connectionsB

Every connection the service currently holds, with its id, URL and state.

teleport_connection_statusA

State of one connection: state (UNCONNECTED, OFFERING, AWAITING_SETUP, HANDSHAKING, CONNECTED, RECONNECTING, DISCONNECTED), server, latency, available inputs and mode. Poll this after teleport_connect.

teleport_disconnectA

Close one connection. The service and any other connections keep running.

teleport_set_poseA

Move and/or turn the client avatar. Position is metres, orientation is a quaternion. At least one of position or orientation must be given.

teleport_list_inputsA

Inputs the server has declared for this connection, with the ids teleport_send_input takes. Empty until the connection reaches CONNECTED and the server sends its input definitions.

teleport_send_inputA

Send one input event. binary takes value 0 or 1; analogue takes a single float; motion takes x and y. Use teleport_list_inputs for the ids the server expects.

teleport_set_modeA

minimal is a network diagnostic: connectivity and stream health, no geometry decoding. simulated exercises the full geometry streaming and acknowledgement flow. Use simulated before expecting teleport_get_geometry to report anything.

teleport_get_geometryA

What the server has streamed to this connection. summary gives counts; nodes lists the tracked scene nodes; resources lists pointer URLs and uids referenced but never sent. uids are decimal strings, not numbers — they exceed what a JSON number can hold.

teleport_identityA

Show, start or clear the service identity. Sign-in uses a device code: action=signin starts it, then poll action=show and read pendingSignIn for the URL and code to give the user. The service has no browser, so relaying that prompt is the only way in.

teleport_raw_commandA

Send one command line to the service verbatim, for anything the tools above do not cover (help lists them all). Note shutdown stops the service and every live stream with it, which is why it has no tool of its own.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/teleportxr/teleport-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server