EdgazeDocsEdgaze Docs
BuilderBilling & RunsAPI ReferenceMCPLegal & TrustChangelog
DocumentationAPI Reference
Home
Edgaze MCP
Connect Edgaze MCPYour first runMCP walletMCP for creators

Platform status

Checking platform status
Theme
Edgaze MCP

Your first run

How the agent should search, inspect, demo, pay, and watch a workflow after Edgaze MCP is connected.

Audience

People who just connected Edgaze MCP, and the agent running the session.

Outcome

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.

  1. edgaze_catalog when you still need a category map.
  2. edgaze_search with the human's goal in their words.
  3. If search returns no_match, stop searching Edgaze. Say so. Use your own tools for the rest of the job.
  4. edgaze_inspect on one slug. Read the input names, required fields, example values, the price, and demo_available. If it returns required_integrations, the workflow acts on the human's own accounts (for example Slack or GitHub).
  5. If integrations_ready is false, do not run yet: edgaze_run would be refused with a connect_url. Give the human that link, let them connect the accounts and approve the listed actions, then retry the same run.
  6. Show the human the price and the fields you still need. Fill inputs from what they said. Ask for anything the schema still requires.
  7. If inspect lists file_inputs, get the file before running. See Files below.
  8. edgaze_run with those named inputs and a max_cost_usd at or above the inspected price. Set demo: true only when inspect said a demo is available and they want the free run. It returns status: "queued": the run may wait for capacity before it starts.
  9. edgaze_watch with run_id and cursor. Wait poll_after_ms after an empty read. Repeat until terminal is true. status reads queued while the run waits in line (with queue and a status message), then running. Then follow present and how_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_upload with the filename. PUT the raw file bytes to upload_url with the headers it returns, then pass file_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.

PreviousConnect Edgaze MCPNextMCP wallet
On this page
Before you runSign inThe loopFilesDemoPaid runHow to show the resultWhat good looks likeNext
© 2026 Edge Platforms, Inc. All rights reserved.