Your first run
How the agent should search, inspect, demo, pay, and watch a workflow after Edgaze MCP is connected.
People who just connected Edgaze MCP, and the agent running the session.
Finish a first demo or paid run without guessing inputs, price, or what a demo is.
Before you run#
Setup must already be done. If the edgaze_* tools are missing, stop and follow Connect Edgaze MCP.
The agent should not invent a slug or an input the form does not accept. It should not start a paid run before it has shown the price.
Sign in#
If a tool call asks you to sign in, finish the consent window the client opened and press Authorize. That page is on www.edgaze.ai. Do not open /oauth/consent yourself. Then retry the same ask. Do not create a second MCP server.
The loop#
Use the tools in this order. Skip catalog when the human already named the job.
edgaze_catalogwhen you still need a category map.edgaze_searchwith the human's goal in their words.- If search returns
no_match, stop searching Edgaze. Say so. Use your own tools for the rest of the job. edgaze_inspecton one slug. Read the input names, required fields, example values, the price, anddemo_available. If it returnsrequired_integrations, the workflow acts on the human's own accounts (for example Slack or GitHub).- If
integrations_readyis false, do not run yet:edgaze_runwould be refused with aconnect_url. Give the human that link, let them connect the accounts and approve the listed actions, then retry the same run. - Show the human the price and the fields you still need. Fill inputs from what they said. Ask for anything the schema still requires.
- If inspect lists
file_inputs, get the file before running. See Files below. edgaze_runwith those named inputs and amax_cost_usdat or above the inspected price. Setdemo: trueonly when inspect said a demo is available and they want the free run. It returnsstatus: "queued": the run may wait for capacity before it starts.edgaze_watchwithrun_idandcursor. Waitpoll_after_msafter an empty read. Repeat untilterminalis true.statusreadsqueuedwhile the run waits in line (withqueueand a status message), thenrunning. Then followpresentandhow_to_show.
Do not poll faster than the server asks. Empty watches are cheap. Do not start a second run for the same ask unless the first one failed or they requested it.
Files#
A tool call is text, so a file cannot be passed by its name. A file input takes one of these values:
- An upload. Call
edgaze_uploadwith the filename.PUTthe raw file bytes toupload_urlwith theheadersit returns, then passfile_value(edgaze-upload:…) as the input. The link works for 2 hours. The upload can be used for 24 hours. Files up to 25 MB. - An
https://URL to the file itself. Edgaze downloads it. Use this when the file is already online. - A
data:<type>;base64,…URI for files under 1 MB only. Prefer an upload.
A multi-file input takes a list of these. Edgaze checks each file from its bytes before the run starts. A file it cannot read is refused with a message that says why, and nothing runs or is charged.
If edgaze_run is called without a required file, it returns status: "input_required" with missing_files and nothing runs. In chats that show the Edgaze run card (like ChatGPT), the person can choose the file in the card and the run starts from there. Otherwise upload the file and call edgaze_run again with the retry.arguments it returned plus the file values.
Demo#
A demo is a real run of the published workflow with the human's inputs. It is not a video and not a mock.
Inspect reports when a demo is available. One signed-in person gets one demo on a workflow that qualifies. A demo differs from the paid run in three ways: it uses the free-tier model, it adds an Edgaze watermark where the product supports it, and it does not run remixed child workflows. It does not pay the creator and it does not take wallet funds.
If a demo is not available, say that and offer the paid run. Do not set demo: true to bypass a missing demo.
Paid run#
Ask the agent to run the same slug with demo off. It will quote the price first. That price is creator margin plus compute. max_cost_usd is a ceiling so the run cannot cost more than you accepted.
If the wallet cannot cover it, the agent should send you to Wallet, wait until you have added money, and retry. See Wallet.
A failed or cancelled run does not keep the charge.
How to show the result#
edgaze_run and a finished edgaze_watch include url: https://www.edgaze.ai/run/{id}. That is the hosted run page. The owner can open it while signed in.
When present is chat, deliver the result in this conversation. Paste text and markdown the person can use. If the workflow did something outside the chat (sent an email, published a post, opened a ticket, scraped a page), say what happened and include any confirmation ids or links from the output. Do not dump raw JSON when a readable answer exists. Offer url if they want the full run page.
When present is edgaze_page, this chat cannot show the result well. That is images, video, files, and other media. Give them url as the place to view and download it. A short caption is fine. Do not paste base64, data URIs, or binary.
What good looks like#
You: Find something that turns a messy meeting note into action items.
The agent searches, inspects one slug, shows the price, asks for the note if you have not pasted it, runs a demo when one exists, watches until the run finishes, and pastes the action items. If the wallet is empty and you want the paid path, it sends you to the wallet and retries after you return.
You: Make a cinematic product shot of this bottle.
The agent runs the workflow, then sends https://www.edgaze.ai/run/{id} so you can open the image on Edgaze. It does not paste the JPEG into chat.
Next#
- Wallet if the paid run is waiting on balance
- For creators if this is your workflow
Was this useful?
Your response helps us improve the documentation.