MCP Tools

The CodeTeleport MCP server registers seven tools. Your AI coding agent — Claude Code, Codex, or Antigravity — can call them in response to natural language prompts.

These tools operate on the agent configured for CodeTeleport (set with codeteleport config set agent <claude-code|codex|antigravity> or interactively via codeteleport setup). Register the server per agent — claude mcp add codeteleport -- codeteleport-mcp, codex mcp add codeteleport -- codeteleport-mcp, or agy mcp add codeteleport -- codeteleport-mcp — or let codeteleport setup run the correct one for the selected agent automatically. See MCP setup for details.

Tool Reference

teleport_push

Push the current agent’s session to CodeTeleport cloud storage. Bundles the agent’s full session state — for Claude Code this is the conversation JSONL plus its sidecars (subagents, file history, paste cache, shell snapshots) and project memory; for Codex it is the rollout transcript plus its thread-inventory row from state_5.sqlite; for Antigravity it is the SQLite conversation DB plus the brain/ directory — together with any extra working files you pass via includePaths. It then uploads the bundle so you can resume on another machine. If the session was previously pushed, it is overwritten with the latest version.

Input	Type	Required	Description
`label`	string	no	Human-readable name for the session
`tags`	string[]	no	Tags for filtering (e.g. `["work", "frontend"]`)
`includePaths`	string[]	no	Absolute paths of extra working/temp files the session created or depends on, e.g. `/tmp/*.json`

Example prompt:

Save this conversation so I can continue on my laptop.
Label it "auth refactor" and tag it "work".

teleport_pull

Pull a session from CodeTeleport cloud to this machine. Downloads the bundle, rewrites all internal paths for this machine’s username and directory structure, and installs it so you can resume where you left off. The resume command and install destination are derived from the bundle’s own recorded agent — claude --resume <id> for Claude Code, codex resume <id> for Codex, or agy --conversation <id> for Antigravity — not from this machine’s configured agent, so a bundle restores correctly even if this machine is set up for a different agent.

Input	Type	Required	Description
`sessionId`	string	no	Pull a specific session by ID. If omitted, lists available sessions.
`version`	number	no	Pull a specific version (default: latest). See versioning.
`targetDir`	string	no	Anchor the session at this directory path (see path rewriting)
`machine`	string	no	Filter listed sessions by source machine name
`agent`	string	no	Scope the listing to an agent (`claude-code`, `codex`, `antigravity`), or `"all"`. Defaults to the configured agent. Does not restrict `sessionId` pulls.
`as`	string	no	Convert the pulled session into this agent’s format on install (`claude-code`, `codex`, or `antigravity`). Transcript-only/lossy. Omit to restore natively.
`limit`	number	no	Max sessions to list (default: 10)

Example prompt:

Pull my latest session from my work machine.

Pull session c3a05473 to /home/bob/projects/myapp.

The returned resume command matches the bundle’s own agent: a Claude Code bundle prints claude --resume c3a05473, a Codex bundle prints codex resume c3a05473, and an Antigravity bundle prints agy --conversation c3a05473.

teleport_list

List sessions stored in CodeTeleport cloud. Shows session ID, agent, source machine, project path, date, size, message count, and tags. Defaults to the configured agent; pass agent to filter (or "all" for every agent).

Input	Type	Required	Description
`machine`	string	no	Filter by machine name
`tag`	string	no	Filter by tag
`agent`	string	no	Filter by agent (`claude-code`, `codex`, `antigravity`), or `"all"`. Defaults to the configured agent.
`limit`	number	no	Max results (default: 20)

Example prompt:

What sessions do I have stored in CodeTeleport?

Show me sessions tagged "work" from my desktop.

teleport_local_list

List all AI coding sessions on the local machine. Scans the configured agent’s local session directory — ~/.claude/projects/ for Claude Code, ~/.codex/sessions/ for Codex, or ~/.gemini/antigravity-cli/conversations/ for Antigravity — and shows session ID, project name, message count, timestamps, and file size. No cloud access needed — reads directly from the local filesystem.

Input	Type	Required	Description
(none)			This tool takes no inputs.

Example prompt:

Show me my local AI coding sessions.

teleport_status

Show CodeTeleport account status. Displays your email, device name, API URL, plan, session and device usage, and last push time.

Input	Type	Required	Description
(none)			This tool takes no inputs.

Example prompt:

What's my CodeTeleport status?

teleport_versions

Show version history for a session stored in CodeTeleport. Returns all versions with size, date, and which is latest.

Input	Type	Required	Description
`sessionId`	string	yes	Session ID to get versions for

Example prompts:

Show me the versions of this session.
What versions do I have for c3a05473?

See Session Versioning for how versions work.

teleport_delete

Permanently delete a session from CodeTeleport cloud storage. This cannot be undone — all versions are deleted.

Input	Type	Required	Description
`sessionId`	string	yes	Full session ID to delete

Example prompt:

Delete session c3a05473-9f12-4a2b-ae27-9478ab66d216.

Error Handling

All tools are wrapped in a safe handler. If a tool call fails — authentication error, network timeout, invalid session ID — the response includes isError: true alongside an error message. Your agent will typically surface this as a natural-language explanation.

Common errors:

Error	Cause
`not authenticated`	No API token configured. Run `codeteleport auth login`.
`session not found`	The session ID does not exist or was already deleted.
`plan limit exceeded`	You have hit your session or device limit. See Plans & Limits.

Next step

See usage examples for full conversation walkthroughs showing these tools in action.