Server definition

Hash: sha256:1b1401fd8d50e86b80e42b12f37d423f3d6b4e9fc0a70304587fd8504d0e2643
What it is: What a remote MCP server returned when asked what it offers: 20 tools

The blob, as servednamed by its sha256

{
  "instructions": "Tools to virtually stage, redesign, enhance, declutter and convert real-estate photos via the AI HomeDesign API. Typical flow: call `list_capabilities` to see the tools, then a high-level helper such as `virtual_staging`, `enhance_image`, `remove_items`, `interior_design` or `day_to_dusk` with a public image URL. For full control use `create_order` -> `run_process` -> `get_process`. Results come back as downloadable image URLs.\n\nPRESENTATION RULES — always obey a tool's `present_instructions` and `action_required` fields when present:\n• Style choice: when a tool returns `need_style` with a `styles` list, do NOT use an interactive dropdown/picker — write your own message listing EVERY style (title + description) as cards, tag 2-3 best fits from the photo, and ask the user to reply. Use only those styles — never invent or substitute names (no 'Mid-Century Modern', 'Coastal', etc.).\n• Results: present each finished image as a downloadable image FILE (a file/preview card), not as a raw text link.",
  "tools": [
    {
      "description": "Change the ceiling finish in a room photo (AI applies a tasteful default).\n    Detect `space` from the image. Provide image_url OR image_base64.",
      "inputSchema": {
        "properties": {
          "image_base64": {
            "default": "",
            "title": "Image Base64",
            "type": "string"
          },
          "image_url": {
            "default": "",
            "title": "Image Url",
            "type": "string"
          },
          "project_id": {
            "default": "",
            "title": "Project Id",
            "type": "string"
          },
          "space": {
            "default": "",
            "title": "Space",
            "type": "string"
          },
          "wait": {
            "default": true,
            "title": "Wait",
            "type": "boolean"
          }
        },
        "title": "change_ceilingArguments",
        "type": "object"
      },
      "name": "change_ceiling",
      "outputSchema": null
    },
    {
      "description": "Change the floor material in a room photo (AI applies a tasteful default\n    material). Detect `space` from the image. Provide image_url OR image_base64.",
      "inputSchema": {
        "properties": {
          "image_base64": {
            "default": "",
            "title": "Image Base64",
            "type": "string"
          },
          "image_url": {
            "default": "",
            "title": "Image Url",
            "type": "string"
          },
          "project_id": {
            "default": "",
            "title": "Project Id",
            "type": "string"
          },
          "space": {
            "default": "",
            "title": "Space",
            "type": "string"
          },
          "wait": {
            "default": true,
            "title": "Wait",
            "type": "boolean"
          }
        },
        "title": "change_floorArguments",
        "type": "object"
      },
      "name": "change_floor",
      "outputSchema": null
    },
    {
      "description": "Change the wall finish/colour in a room photo (AI applies a tasteful default\n    finish). Detect `space` (room type) from the image. Provide image_url OR image_base64.",
      "inputSchema": {
        "properties": {
          "image_base64": {
            "default": "",
            "title": "Image Base64",
            "type": "string"
          },
          "image_url": {
            "default": "",
            "title": "Image Url",
            "type": "string"
          },
          "project_id": {
            "default": "",
            "title": "Project Id",
            "type": "string"
          },
          "space": {
            "default": "",
            "title": "Space",
            "type": "string"
          },
          "wait": {
            "default": true,
            "title": "Wait",
            "type": "boolean"
          }
        },
        "title": "change_wallArguments",
        "type": "object"
      },
      "name": "change_wall",
      "outputSchema": null
    },
    {
      "description": "Upload one or more images and create an order. Provide `image_urls` (public\n    URLs) and/or `image_base64` (raw base64 or data: URLs) — you can use either.\n\n    Returns `order_id` and an `assets` list whose `id`s you map to a tool's input\n    slot when running a process. For two-image tools pass roles like\n    ['primary_angle','secondary_angle'] (or 'mask' for mask tools).",
      "inputSchema": {
        "properties": {
          "asset_roles": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Asset Roles"
          },
          "image_base64": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Image Base64"
          },
          "image_urls": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Image Urls"
          },
          "project_id": {
            "default": "",
            "title": "Project Id",
            "type": "string"
          }
        },
        "title": "create_orderArguments",
        "type": "object"
      },
      "name": "create_order",
      "outputSchema": null
    },
    {
      "description": "Create a project (a container that groups all work for one property).\n    Returns the new project's `id`.",
      "inputSchema": {
        "properties": {
          "address": {
            "title": "Address",
            "type": "string"
          }
        },
        "required": [
          "address"
        ],
        "title": "create_projectArguments",
        "type": "object"
      },
      "name": "create_project",
      "outputSchema": null
    },
    {
      "description": "Convert a daytime EXTERIOR photo into a dusk / twilight scene. No style needed.\n    Provide image_url OR image_base64.\n\n    sky_style: leave empty to use the default sky (recommended — the 30+ named sky\n    slugs are not publicly listed). options (multi, optional): shadow-removal,\n    lawn-touch-up.",
      "inputSchema": {
        "properties": {
          "image_base64": {
            "default": "",
            "title": "Image Base64",
            "type": "string"
          },
          "image_url": {
            "default": "",
            "title": "Image Url",
            "type": "string"
          },
          "options": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Options"
          },
          "project_id": {
            "default": "",
            "title": "Project Id",
            "type": "string"
          },
          "sky_style": {
            "default": "",
            "title": "Sky Style",
            "type": "string"
          },
          "wait": {
            "default": true,
            "title": "Wait",
            "type": "boolean"
          }
        },
        "title": "day_to_duskArguments",
        "type": "object"
      },
      "name": "day_to_dusk",
      "outputSchema": null
    },
    {
      "description": "Show the input slots, widgets and selectable options for one tool, plus a\n    ready-to-use example payload for `run_process`. Use this before `run_process`\n    when you need the exact widget/item slugs for a tool.",
      "inputSchema": {
        "properties": {
          "tool_slug": {
            "title": "Tool Slug",
            "type": "string"
          }
        },
        "required": [
          "tool_slug"
        ],
        "title": "describe_toolArguments",
        "type": "object"
      },
      "name": "describe_tool",
      "outputSchema": null
    },
    {
      "description": "Enhance a photo: better lighting, sharpness and colour balance. No style\n    needed. Provide image_url OR image_base64.\n\n    area: indoor | outdoor (detect from the image). options (multi, optional):\n    add-fire-to-fireplace, add-screen-to-tv.",
      "inputSchema": {
        "properties": {
          "area": {
            "default": "indoor",
            "title": "Area",
            "type": "string"
          },
          "image_base64": {
            "default": "",
            "title": "Image Base64",
            "type": "string"
          },
          "image_url": {
            "default": "",
            "title": "Image Url",
            "type": "string"
          },
          "options": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Options"
          },
          "project_id": {
            "default": "",
            "title": "Project Id",
            "type": "string"
          },
          "wait": {
            "default": true,
            "title": "Wait",
            "type": "boolean"
          }
        },
        "title": "enhance_imageArguments",
        "type": "object"
      },
      "name": "enhance_image",
      "outputSchema": null
    },
    {
      "description": "Fetch an order, including its input assets and any processes run on it.",
      "inputSchema": {
        "properties": {
          "order_id": {
            "title": "Order Id",
            "type": "string"
          }
        },
        "required": [
          "order_id"
        ],
        "title": "get_orderArguments",
        "type": "object"
      },
      "name": "get_order",
      "outputSchema": null
    },
    {
      "description": "Fetch a process: its `status` (pending/processing/done/failed) and, when\n    done, the `final_assets` with downloadable result image URLs. If a webhook\n    result has already arrived for this process, it is returned immediately.",
      "inputSchema": {
        "properties": {
          "process_id": {
            "title": "Process Id",
            "type": "string"
          }
        },
        "required": [
          "process_id"
        ],
        "title": "get_processArguments",
        "type": "object"
      },
      "name": "get_process",
      "outputSchema": null
    },
    {
      "description": "Fetch a single project by id.",
      "inputSchema": {
        "properties": {
          "project_id": {
            "title": "Project Id",
            "type": "string"
          }
        },
        "required": [
          "project_id"
        ],
        "title": "get_projectArguments",
        "type": "object"
      },
      "name": "get_project",
      "outputSchema": null
    },
    {
      "description": "Fully redesign a FURNISHED room (walls, floors, furniture, decor) in a style.\n    Same workflow as virtual_staging: never pick the style yourself — ask the user;\n    detect the room type from the image. Provide image_url OR image_base64.",
      "inputSchema": {
        "properties": {
          "image_base64": {
            "default": "",
            "title": "Image Base64",
            "type": "string"
          },
          "image_url": {
            "default": "",
            "title": "Image Url",
            "type": "string"
          },
          "project_id": {
            "default": "",
            "title": "Project Id",
            "type": "string"
          },
          "space": {
            "default": "",
            "title": "Space",
            "type": "string"
          },
          "style": {
            "default": "",
            "title": "Style",
            "type": "string"
          },
          "wait": {
            "default": true,
            "title": "Wait",
            "type": "boolean"
          }
        },
        "title": "interior_designArguments",
        "type": "object"
      },
      "name": "interior_design",
      "outputSchema": null
    },
    {
      "description": "List every AI HomeDesign tool this MCP can run, grouped by category.\n\n    Returns each tool's slug, display name, description and whether it needs\n    one or two input images. Start here to discover what is available.",
      "inputSchema": {
        "properties": {},
        "title": "list_capabilitiesArguments",
        "type": "object"
      },
      "name": "list_capabilities",
      "outputSchema": null
    },
    {
      "description": "List your projects (paginated). Optional free-text `search` on address.",
      "inputSchema": {
        "properties": {
          "limit": {
            "default": 10,
            "title": "Limit",
            "type": "integer"
          },
          "page": {
            "default": 1,
            "title": "Page",
            "type": "integer"
          },
          "search": {
            "default": "",
            "title": "Search",
            "type": "string"
          }
        },
        "title": "list_projectsArguments",
        "type": "object"
      },
      "name": "list_projects",
      "outputSchema": null
    },
    {
      "description": "List the allowed design styles, room types and widget options. With no\n    argument, returns the global style/room/area lists. With a tool_slug, returns\n    that tool's widgets and their allowed values. The staging/design helpers\n    ONLY accept these values — anything else is rejected before calling the API.",
      "inputSchema": {
        "properties": {
          "tool_slug": {
            "default": "",
            "title": "Tool Slug",
            "type": "string"
          }
        },
        "title": "list_stylesArguments",
        "type": "object"
      },
      "name": "list_styles",
      "outputSchema": null
    },
    {
      "description": "Auto-detect and remove furniture/clutter from a room photo (decluttering),\n    leaving a clean empty space. No style needed. Provide image_url OR image_base64.",
      "inputSchema": {
        "properties": {
          "image_base64": {
            "default": "",
            "title": "Image Base64",
            "type": "string"
          },
          "image_url": {
            "default": "",
            "title": "Image Url",
            "type": "string"
          },
          "project_id": {
            "default": "",
            "title": "Project Id",
            "type": "string"
          },
          "wait": {
            "default": true,
            "title": "Wait",
            "type": "boolean"
          }
        },
        "title": "remove_itemsArguments",
        "type": "object"
      },
      "name": "remove_items",
      "outputSchema": null
    },
    {
      "description": "Start an AI job on an existing order (full control over every tool).\n\n    `asset_map` maps each of the tool's input-slot keys to an asset id from the\n    order. `widgets` is the raw list of {slug, item_slugs}. Use `describe_tool`\n    to get the exact slugs. Returns `process_ids` to poll with `get_process`.",
      "inputSchema": {
        "properties": {
          "asset_map": {
            "additionalProperties": true,
            "title": "Asset Map",
            "type": "object"
          },
          "order_id": {
            "title": "Order Id",
            "type": "string"
          },
          "process_group_id": {
            "default": "",
            "title": "Process Group Id",
            "type": "string"
          },
          "tool": {
            "title": "Tool",
            "type": "string"
          },
          "widgets": {
            "anyOf": [
              {
                "items": {},
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "title": "Widgets"
          }
        },
        "required": [
          "order_id",
          "tool",
          "asset_map"
        ],
        "title": "run_processArguments",
        "type": "object"
      },
      "name": "run_process",
      "outputSchema": null
    },
    {
      "description": "Replace the furniture in an ALREADY-FURNISHED room with a new design style.\n    Same workflow as virtual_staging: ask the user for the style, detect the room\n    type from the image. Provide image_url OR image_base64.",
      "inputSchema": {
        "properties": {
          "image_base64": {
            "default": "",
            "title": "Image Base64",
            "type": "string"
          },
          "image_url": {
            "default": "",
            "title": "Image Url",
            "type": "string"
          },
          "project_id": {
            "default": "",
            "title": "Project Id",
            "type": "string"
          },
          "space": {
            "default": "",
            "title": "Space",
            "type": "string"
          },
          "style": {
            "default": "",
            "title": "Style",
            "type": "string"
          },
          "wait": {
            "default": true,
            "title": "Wait",
            "type": "boolean"
          }
        },
        "title": "virtual_restagingArguments",
        "type": "object"
      },
      "name": "virtual_restaging",
      "outputSchema": null
    },
    {
      "description": "Furnish an EMPTY room photo with AI furniture in a chosen design style.\n\n    Provide the photo as `image_url` OR `image_base64` (raw base64 or a data: URL).\n    WORKFLOW — follow exactly:\n    • Do NOT choose a `style` yourself. Call this first with style empty; it returns\n      the list of design styles. Present them to the user and let THEM pick, then call\n      again with their chosen style.\n    • Detect `space` (room type) from the image yourself and pass it (bedroom, kitchen,\n      living-room, ...). Only if you truly cannot tell, leave it empty and the tool\n      will ask the user.",
      "inputSchema": {
        "properties": {
          "image_base64": {
            "default": "",
            "title": "Image Base64",
            "type": "string"
          },
          "image_url": {
            "default": "",
            "title": "Image Url",
            "type": "string"
          },
          "project_id": {
            "default": "",
            "title": "Project Id",
            "type": "string"
          },
          "space": {
            "default": "",
            "title": "Space",
            "type": "string"
          },
          "style": {
            "default": "",
            "title": "Style",
            "type": "string"
          },
          "wait": {
            "default": true,
            "title": "Wait",
            "type": "boolean"
          }
        },
        "title": "virtual_stagingArguments",
        "type": "object"
      },
      "name": "virtual_staging",
      "outputSchema": null
    },
    {
      "description": "Poll a process until it is `done` or `failed` (or until timeout), then\n    return the final result image URLs. Respects the API's 5s minimum poll\n    interval.",
      "inputSchema": {
        "properties": {
          "poll_seconds": {
            "default": 6,
            "title": "Poll Seconds",
            "type": "integer"
          },
          "process_id": {
            "title": "Process Id",
            "type": "string"
          },
          "timeout_seconds": {
            "default": 180,
            "title": "Timeout Seconds",
            "type": "integer"
          }
        },
        "required": [
          "process_id"
        ],
        "title": "wait_for_resultArguments",
        "type": "object"
      },
      "name": "wait_for_result",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:1b1401fd8d50e86b80e42b12f37d423f3d6b4e9fc0a70304587fd8504d0e2643 | sha256sum