MCP Tools Reference

The Geoff MCP server exposes 57 tools across 20 groups. Each tool accepts Zod-validated input and returns JSON content.

Text / Chat

`text_chat`

Send a chat prompt to Geoff and receive a text response.

Parameter	Type	Required	Description
`prompt`	string	Yes	The user prompt to send
`model`	string	No	Model identifier
`system`	string	No	System prompt
`temperature`	number	No	Sampling temperature
`maxTokens`	number	No	Max tokens to generate

Code

`code_execute`

Execute code and return stdout, stderr, and exit code.

Parameter	Type	Required	Description
`code`	string	Yes	The code to execute
`language`	string	No	Programming language

`code_create_sandbox`

Create a new code execution sandbox.

Parameter	Type	Required	Description
`image`	string	No	Docker image

`code_stream`

Stream code execution output from a sandbox.

Parameter	Type	Required	Description
`sandboxId`	string	Yes	The sandbox identifier
`code`	string	Yes	The code to stream

`code_sandbox_status`

Get the status of a code execution sandbox.

Parameter	Type	Required	Description
`sandboxId`	string	Yes	The sandbox identifier

Image

`image_text_to_image`

Generate an image from a text prompt. Supports max mode for higher quality.

Parameter	Type	Required	Description
`prompt`	string	Yes	Text description of the image
`width`	number	No	Image width in pixels
`height`	number	No	Image height in pixels
`maxMode`	boolean	No	Enable max mode for higher quality

`image_image_to_image`

Transform an existing image using a text prompt.

Parameter	Type	Required	Description
`prompt`	string	Yes	Transformation description
`sourceImage`	string	Yes	URL or ID of the source image
`strength`	number	No	Transformation strength (0-1)

Video

`video_text_to_video`

Generate a video from a text prompt.

Parameter	Type	Required	Description
`prompt`	string	Yes	Text description of the video
`duration`	number	No	Duration in seconds
`width`	number	No	Video width
`height`	number	No	Video height

`video_query_status`

Check the status of an async video generation task.

Parameter	Type	Required	Description
`taskId`	string	Yes	The task ID returned by video generation

Music

`music_generate`

Generate music from a text prompt.

Parameter	Type	Required	Description
`prompt`	string	Yes	Text description of the music
`duration`	number	No	Duration in seconds
`lyrics`	string	No	Lyrics text

Speech

`speech_text_to_speech`

Convert text to speech audio.

Parameter	Type	Required	Description
`text`	string	Yes	The text to synthesize
`voice`	string	No	Voice ID or name
`format`	string	No	Audio format

`speech_clone_voice`

Clone a voice from an audio sample.

Parameter	Type	Required	Description
`audioUrl`	string	Yes	URL of the reference audio

File

`file_list`

List uploaded files. No parameters.

`file_retrieve`

Retrieve metadata for a specific file.

Parameter	Type	Required	Description
`fileId`	string	Yes	The file ID

`file_delete`

Delete a file.

Parameter	Type	Required	Description
`fileId`	string	Yes	The file ID to delete

Training

`training_image_lora`

Start a LoRA training job from a set of images.

Parameter	Type	Required	Description
`images`	string[]	Yes	Array of image URLs
`baseModel`	string	No	Base model name

`training_get_status`

Check the status of a training job.

Parameter	Type	Required	Description
`taskId`	string	Yes	The training task ID

`social_create_join_code`

Create a join code for inviting users. No parameters.

`social_create_invite`

Create an invitation for a user.

Parameter	Type	Required	Description
`email`	string	No	Email address for the invite

HQ — Agents, Squads, and Swarms

`hq_list_agents`

List all HQ agents. No parameters.

`hq_create_agent`

Create a new HQ agent.

Parameter	Type	Required	Description
`name`	string	Yes	Agent name
`type`	string	Yes	Agent type

`hq_list_squads`

List all HQ squads. No parameters.

`hq_create_squad`

Create a new squad with agents.

Parameter	Type	Required	Description
`name`	string	Yes	Squad name
`agentIds`	string[]	Yes	Agent IDs to include

`hq_agents_search`

Search the agency-agents specialist roster (232 agents across 16 divisions).

Parameter	Type	Required	Description
`query`	string	Yes	Natural-language search query
`division`	string	No	Division filter (engineering, marketing, etc.)

`hq_agents_inspect`

Inspect one agency-agents specialist by slug or name.

Parameter	Type	Required	Description
`slug`	string	Yes	Agent slug or exact display name

`hq_agents_load`

Load a specialist as a prompt block for the current task.

Parameter	Type	Required	Description
`slug`	string	Yes	Agent slug or exact display name
`task`	string	Yes	The task to pair with the specialist context

`hq_agents_delegate`

Delegate a task to one specialist agent.

Parameter	Type	Required	Description
`slug`	string	Yes	Agent slug or exact display name
`task`	string	Yes	Concrete task for the specialist

Skills

`skills_list`

List all registered skills. No parameters.

`skills_get`

Get full details for a specific skill.

Parameter	Type	Required	Description
`id`	string	Yes	The skill ID

`skills_invoke`

Invoke a skill with the given input.

Parameter	Type	Required	Description
`id`	string	Yes	The skill ID to invoke
`input`	string	Yes	The input text for the skill

`skills_publish`

Publish a new skill.

Parameter	Type	Required	Description
`name`	string	Yes	Skill name
`description`	string	Yes	Skill description
`body`	string	No	Skill body / prompt content

Assets

`asset_list`

List recently generated assets (images, videos, audio). No parameters.

`asset_get_metadata`

Get full metadata for a specific asset, including provenance.

Parameter	Type	Required	Description
`assetId`	string	Yes	The asset ID

`asset_regenerate`

Re-run the workflow that produced an asset, with the same parameters.

Parameter	Type	Required	Description
`assetId`	string	Yes	The asset ID to regenerate

Defaults

`defaults_get`

Get the current generation defaults. No parameters.

`defaults_set`

Update generation defaults. Optionally persist to file.

Parameter	Type	Required	Description
`values`	`Record<string, unknown>`	Yes	Key-value pairs to merge into defaults
`persist`	boolean	No	If true, persist to config file

Diagnostics

`diagnostics_get_logs`

Get server logs. No parameters.

`diagnostics_get_history`

Get execution history with error details, timing, and cached node info. No parameters.

`diagnostics_get_system_stats`

Get system information — GPU, VRAM, Python version, OS. No parameters.

Content Types

`content_types_list`

List all registered content types. No parameters.

`content_types_get`

Get details for a specific content type.

Parameter	Type	Required	Description
`id`	string	Yes	The content type ID

Catalog

`catalog_list_tools`

List all tools in the Geoff catalog. No parameters.

`catalog_get_tool`

Get details for a specific catalog tool.

Parameter	Type	Required	Description
`id`	string	Yes	The tool ID

`catalog_list_rack`

List all entries in the rack. No parameters.

Studio

`studio_list_modes`

List all creative studio modes. No parameters.

`studio_list_templates`

List all studio workflow templates. No parameters.

`studio_get_template`

Get details for a specific studio template.

Parameter	Type	Required	Description
`id`	string	Yes	The template ID

`studio_fork_template`

Fork a studio template into your stack.

Parameter	Type	Required	Description
`repoId`	string	Yes	The repository ID to fork

​MCP Tools Reference

​Text / Chat

​text_chat

​Code

​code_execute

​code_create_sandbox

​code_stream

​code_sandbox_status

​Image

​image_text_to_image

​image_image_to_image

​Video

​video_text_to_video

​video_query_status

​Music

​music_generate

​Speech

​speech_text_to_speech

​speech_clone_voice

​File

​file_list

​file_retrieve

​file_delete

​Training

​training_image_lora

​training_get_status

​Social

​social_create_join_code

​social_create_invite

​HQ — Agents, Squads, and Swarms

​hq_list_agents

​hq_create_agent

​hq_list_squads

​hq_create_squad

​hq_agents_search

​hq_agents_inspect

​hq_agents_load

​hq_agents_delegate

​Skills

​skills_list

​skills_get

​skills_invoke

​skills_publish

​Assets

​asset_list

​asset_get_metadata

​asset_regenerate

​Defaults

​defaults_get

​defaults_set

​Diagnostics

​diagnostics_get_logs

​diagnostics_get_history

​diagnostics_get_system_stats

​Content Types

​content_types_list

​content_types_get

​Catalog

​catalog_list_tools

​catalog_get_tool

​catalog_list_rack

​Studio

​studio_list_modes

​studio_list_templates

​studio_get_template

​studio_fork_template