Skip to content

MCP Tool Reference

gthonragents mcp exposes 23 tools through a local stdio server.

Tool Purpose
gthonragents_auth_status Inspect the shared local credential state
gthonragents_login Start device authorization without opening a browser at startup
gthonragents_login_poll Complete a previously started login session
gthonragents_logout Delete persistent local credentials

No authentication tool returns raw credentials. Logout cannot clear an active GTHONRAGENTS_API_KEY environment value or revoke a remote credential.

Tool Purpose
gthonragents_status Check account and server state
gthonragents_list_models Discover current models by capability
gthonragents_model_schema Retrieve the exact selected operation and mode contract
  • gthonragents_image_generate
  • gthonragents_image_edit
  • gthonragents_image_upscale
  • gthonragents_image_read
  • gthonragents_video_generate
  • gthonragents_video_read
  • gthonragents_music_generate
  • gthonragents_audio_read
  • gthonragents_web_search
  • gthonragents_web_crawl
  • gthonragents_drive_list
  • gthonragents_drive_get
  • gthonragents_drive_resolve_path
  • gthonragents_page_list
  • gthonragents_page_get
  • gthonragents_page_versions

Seven tools accept HTTP(S) URLs, existing GthonrAgents upload references, or authorized local paths:

  • image generate, edit, upscale, and read
  • video generate and read
  • audio read

See Security and local file access before granting roots.