Agent API

RoomsGPT MCP Server

MCP-compatible agents can discover the RoomsGPT tools for free, then pay per generation with x402 before creating images. The normal RoomsGPT website and account flow continue to work separately from this server.

Price

$0.25

USDC per paid tool call

Network

Base USDC

eip155:8453

Endpoint

https://us-central1-ai-apps-prod.cloudfunctions.net/mcp

Payment Recipient

x402 payments settle to this wallet address. The private key is not stored in this repository.

0x53A595266aee7aa034095344bF1E885180FA7E21

Tools

generate_design

Interior design, home exterior, garden design, virtual staging, and custom room prompts from an input image.

$0.25 USDC

edit_surface

Paint colors, material changes, and multi-surface color edits from an input image.

$0.25 USDC

Client Setup

Add the server URL to any MCP client that supports Streamable HTTP. Discovery requests are free. Paid tool calls receive a 402 response when the x402 payment header is missing.

{
  "mcpServers": {
    "roomsgpt": {
      "url": "https://us-central1-ai-apps-prod.cloudfunctions.net/mcp"
    }
  }
}

Generation Flow

Initialize the MCP server and list tools.
Call a paid tool without payment to receive x402 terms.
Sign and attach the x402 payment header.
Retry the same tool call to generate the image.