MCP use cases & prompts

Copy these prompts into Cursor, Claude Desktop, or any host with Gommo MCP connected. Say "use Gommo MCP" if you have multiple MCP servers.

Same path as Quickstart (one image job)

REST integrators: Quickstart → Request lifecycle. MCP mirrors that flow with tools (token from /app/token/):

REST step	MCP tool
Check credits / session	gommo_credit_balance or gommo_account_info
POST /ai/models?type=image	gommo_models_list — never guess ratio / mode
POST /ai/jobs/image/{slug}	gommo_image_create with catalog enums only
Poll until result_url	gommo_task_stream or gommo_image_status on id_base

Gommo MCP — same as Quickstart:
1. gommo_credit_balance
2. gommo_models_list type=image — pick model, ratio, mode from response only
3. gommo_image_create with my prompt and catalog fields
4. gommo_task_stream until success; return the output URL

→ Read the catalog · Common errors

Quick reads (no credit cost)

Goal	Example prompt
Credit balance	Use Gommo MCP: check my credit balance.
Full profile	Use Gommo MCP: show my account info.
Image models	List all image models with ratio and mode options.
Video models	List video models and valid duration values.
Recent jobs	Show my recent image and video tasks.

---

Create image (consumes credits)

Use Gommo MCP:
1. Check my credit balance
2. List image models
3. Create an image with [model from list], prompt "[your prompt]", ratio from catalog only
4. Use gommo_task_stream until done and give me the output URL

Shorter:

Gommo MCP: list image models, then create a sunset beach photo using a catalog ratio, wait for the result.

---

Create video (consumes credits)

Use Gommo MCP:
1. gommo_credit_balance
2. gommo_models_list type=video
3. gommo_video_create with confirmed model, prompt, ratio, duration from catalog
4. gommo_task_stream type=video until success or failure

---

Poll manually (without stream)

Check gommo_image_status for id_base [paste id_base from create].

Or list jobs:

Use gommo_tasks_list type=all limit=20 — find my latest image job.

---

Notification when done

After a long job, ask the agent to notify you:

When the video finishes, use gommo_notify_send with title "Done" and message including the output URL.

gommo_notify_send sends inbox + optional push/Telegram (if linked on your Gommo account). The agent does not call this automatically — you must ask.

---

Full tour (all tool types)

One session to try read + create + list + notify:

Gommo MCP full tour:
1. Account info + credit balance
2. List image and video models
3. Create one small test image (cheap model if available)
4. gommo_task_stream until URL
5. gommo_tasks_list — show recent jobs
6. (Optional) gommo_notify_send "Tour complete" with the image URL

---

Agent rules (remind the AI)

Paste into project rules or chat if the agent guesses enums:

• Always call gommo_models_list before create
• Never invent ratio, mode, resolution, duration
• After create, poll with id_base only — never internal task_id
• Check gommo_credit_balance before image/video create

---

Standard workflow diagram

gommo_credit_balance
        ↓
gommo_models_list
        ↓
gommo_image_create  or  gommo_video_create
        ↓
gommo_task_stream  (or gommo_*_status)
        ↓
gommo_notify_send  (optional)
        ↓
gommo_tasks_list  (review history)

---

Next

→ Tool reference · Other hosts