FlyMy MCP Gateway - Tool Reference

The FlyMy MCP gateway exposes the whole FlyMy.AI platform - agents, frozen compilations, media models, the connector catalog, external MCP servers, skills, files, and billing - as a single MCP server your AI client can call.

Endpoint	https://mcp-agents.flymy.ai/mcp
Transport	Streamable HTTP
Auth (GUI clients)	OAuth sign-in on connect (Claude Desktop, claude.ai, ChatGPT)
Auth (CLI / config clients)	Header X-API-Key: YOUR_KEY - get a key at app.flymy.ai/profile

One-line connect for Claude Code:

claude mcp add --transport http flymyai https://mcp-agents.flymy.ai/mcp --header "X-API-Key: YOUR_KEY"

For Cursor, Codex, Windsurf, Antigravity, and GUI clients, see Connect Your Agent.

The tool list is dynamic

The gateway currently exposes about 54 tools. The list is discovered at runtime via tools/list and may grow - treat the tables below as a snapshot of the stable core, and treat tools/list as the source of truth. Descriptions of each tool's exact parameters come from the tool schemas your client receives on connect.

Agents

Create, run, and manage cloud agents. Runs execute asynchronously in the FlyMy.AI cloud - start a run, then poll it with get_run.

Tool	What it does
create_agent	Create an agent with a name, goal, and optional tools and schemas
get_agent	Fetch one agent with full details
list_agents	List your agents
update_agent	Patch an agent's fields - send only what changes
delete_agent	Delete (archive) an agent
copy_agent	Duplicate an existing agent
run_agent	Start a run; the agent executes asynchronously in the cloud
append_message	Add a follow-up message to a run and continue the agent loop
get_run	Get a run's status, output, error, and logs
cancel_run	Cancel a run that is still in progress
favorite_run	Mark a run as a favorite
set_agent_public	Toggle an agent's public visibility
set_effort	Adjust the agent's effort setting
suggest_schema	Suggest an input/output schema for an agent

Human-in-the-loop

On sensitive actions the agent pauses the run and raises an approval request in the app (app.flymy.ai); the run continues after the owner approves.

Freeze and Compilations

A frozen compilation replays a fixed instruction - deterministic, cheaper, faster. A model update never changes a frozen endpoint; you cut a new version when you choose. "Freeze" and "compile" are the same operation - see Freeze & Re-run.

Tool	What it does
freeze_agent	Freeze a successful run into a fixed instruction (compilation)
run_frozen	Run a frozen compilation, optionally with fresh variables
get_compilation	Fetch one compilation with its status and instruction
list_compilations	List your compilations
update_compilation	Update a compilation's settings
schedule_agent	Set a 5-field cron schedule (plus optional IANA timezone) on a compilation; the schedule fires per compilation

Models

Direct access to the FlyMy.AI model catalog - image, video, and other generative models. The catalog changes over time, so discover models at call time instead of hardcoding names.

Tool	What it does
recommend_model	Pick the best model for a task; the authoritative list of available models
get_model_schema	Return the input parameter schema for a model_id
run_model	Run a chosen model_id with parameters from its schema; billed to your key
list_media_models	List available media generation models
flymyai_models	List models available on FlyMy.AI
get_pricing	Return the real billed cost per run

Tools and Connectors

The platform connector catalog - search it, add a connector, configure it, and call its actions directly without running a full agent.

Tool	What it does
search_tools	Search the connector catalog by keyword
list_configured_tools	List the tools you have already added
execute_tool	Call a configured tool's action directly
add_tool	Add a tool from the catalog to your workspace
update_tool	Update a tool's settings
delete_tool	Remove a tool from your workspace
set_tool_config	Set a tool's configuration values
provide_tool_config	Provide values for a tool's next configuration step (for example an API key)

External MCP Servers

Bring your own MCP servers: register any external server, connect it, and call its tools through the gateway.

Tool	What it does
add_mcp_server	Register an external MCP server
list_mcp_servers	List your registered external MCP servers
update_mcp_server	Update a registered server's settings
delete_mcp_server	Remove a registered server
connect_mcp_server	Connect to a registered server
disconnect_mcp_server	Disconnect from a server
call_mcp_server	Call a tool on a connected external MCP server

Skills

Reusable skills you can attach to agents.

Tool	What it does
create_skill	Create a skill
get_skill	Fetch one skill
list_skills	List your skills
attach_skill	Attach a skill to an agent
detach_skill	Detach a skill from an agent

Files

Files attached to an agent - inputs it should work with and outputs it produced.

Tool	What it does
attach_files	Attach files to an agent
list_agent_files	List files attached to an agent
files_tree	Show an agent's file tree
download_file	Download a file
delete_agent_file	Delete a file from an agent

Billing

Billing is per-use, no subscription. These tools return the real billed cost of runs.

Tool	What it does
get_execution_price	Real billed cost of a single run
list_execution_prices	Billed costs across runs

Identity

Tool	What it does
whoami	Return the authenticated account

Prefer REST or an SDK?

Everything the gateway does is also available programmatically: the agents API lives at https://backend.flymy.ai/api/v1/agents/..., the models API at https://api.flymy.ai/api/v1/..., both with the same X-API-KEY header. The Python SDK wraps the agents API end to end.

Next Steps

• Connect Your Agent - per-client setup for Claude Code, Claude Desktop, claude.ai, ChatGPT, Cursor, Codex, Windsurf, and Antigravity
• Python SDK - the same platform from Python: client.agents, client.runs, client.tools, client.compilations