get_visualization
get_visualization fetches the colours of a /mcp/tools/visualize-room/ job that were not ready yet, by job_id and project_id. It waits up to about 25 seconds. Call it again if the result still reports unfinished colours.
Cost: Free. It costs no credits. Under x402 it also runs without a payment: the job id is the proof of purchase. It still needs a key or x402 to be enabled on the connection, and the job must belong to the account that ran it (under x402, to Muro’s service account).
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
job_id |
string, 1 to 100 chars | yes | job_id from visualize_room. |
|
project_id |
string, 1 to 100 chars | yes | project_id from visualize_room. |
|
country |
string, max 40 chars | no | Where the user buys paint, e.g. “PL”, “DE”, “US”: brands sold there come first in the shopping list. | |
match_brands |
array of strings (max 60 chars each), max 10 items | no | all brands | Only list paints from these brands. |
matches |
integer, 0 to 10 | no | 5 | Paints to list per colour. 0 means no shopping list. |
Returns
Section titled “Returns”Same shape as /mcp/tools/visualize-room/: MCP image content for each finished colour with its caption and shopping list, a final status text, and structuredContent with project_id, job_id, status, result_url and colors. The cost and credits_left fields are not included, because nothing is charged.
If colours are still running, the status text says Painted N of M so far and repeats the call to make. Colours that failed are listed with their error.
Example
Section titled “Example”Arguments:
{ "job_id": "job_456", "project_id": "proj_123", "country": "US" }The result has the same shape as in visualize_room. Calling with ids that do not exist (captured, no key on the connection and x402 enabled) returns:
Muro could not find that project or job. It may belong to another account.with isError: true.
- Use the
job_idandproject_idexactly asvisualize_roomreturned them. - The shopping list is recomputed from the catalogue on each call, so you can change
country,match_brandsandmatchesbetween calls. - Without a key and without x402 enabled, the tool returns the same “needs a Muro account” error as the other paid tools.