makefx.app
Agent connection

MCP

Connect an MCP client and let an agent work on the same canvas you see.

makefx exposes one hosted Model Context Protocol endpoint at https://makefx.app/mcp. It uses Streamable HTTP and OAuth 2.1, so an MCP client can connect without copying a makefx token or provider key into its configuration.

Connect

Add the endpoint URL to an MCP client that supports remote HTTP servers. The client discovers the authorization server, registers itself when necessary and opens a consent page. Sign in with Google and approve the scopes the client needs. No client id, secret or API key is entered anywhere.

  • Claude (web and desktop) — on Free, Pro or Max, open Customize → Connectors → Add custom connector, paste https://makefx.app/mcp, then Connect. On Team or Enterprise, an owner first adds the connector with that URL in Organization settings → Connectors; each member then connects it under Customize → Connectors.

  • Claude Code — claude mcp add --transport http makefx https://makefx.app/mcp, then /mcp → makefx → Authenticate.

  • Codex — add [mcp_servers.makefx] with url = "https://makefx.app/mcp" to ~/.codex/config.toml, then codex mcp login makefx.

  • Cursor — add { "mcpServers": { "makefx": { "url": "https://makefx.app/mcp" } } } to ~/.cursor/mcp.json.

  • read allows inspection.

  • write allows changes on the person's behalf.

Access is still limited by the person's role in each account or space. To disconnect an agent, open your profile and revoke it under Connected agents; its tokens stop working at once.

Try it

Once connected, ask the agent in plain words:

  • "Who am I signed in as on makefx, and how many credits do I have?"
  • "Make a makefx space called Salt Harbour and give me the link."
  • "Quote three 8-second 1080p video clips of a harbour at low tide before making anything."
  • "Describe the starred image in Salt Harbour so the next prompts keep its look."

Every tool declares whether it only reads or changes something. Clients such as Claude may run the reading tools — profile, account, spaces, catalog, quotes — without asking, and ask you before a tool creates, changes, deletes or spends credits.

Work safely

Call tools/list at the start of a session. It is the authority for current tool names and schemas.

A reliable generation sequence is:

  1. list_spaces and choose the intended space.
  2. list_models and choose from the live catalog.
  3. estimate_credits with the intended settings and references.
  4. Ask the person to accept the price.
  5. create_asset with a stable request_id.
  6. get_asset until the result is ready or failed.
  7. Hand the returned web URL to the person.

Use upload_asset for an existing local file. The tool returns a one-use PUT URL; media bytes do not pass through MCP. Use get_space to inspect the whole canvas, update_asset for editable metadata, describe_asset for visual traits, and export_space for the metadata record.

Discovery and errors

The server card, OpenAPI document and developer page describe the same deployment. Tool failures are structured results with a code, message, retryable flag and details. Treat insufficient_credits, forbidden, validation failures and provider failures as different conditions; do not turn every failure into another paid call.