Agent API

HomeGPT MCP Server

MCP-compatible agents can discover HomeGPT tools for free, then pay per generation with x402 before creating exterior, garden, paint, and outdoor design previews. The normal HomeGPT website remains free and separate from this agent endpoint.

Price

$0.25

USDC per paid tool call

Network

Base USDC

eip155:8453

Endpoint

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

Payment Recipient

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

0x53A595266aee7aa034095344bF1E885180FA7E21

Tools

generate_exterior_design

Generate home exterior, garden, landscape, patio, deck, fence, or custom outdoor design previews from an input image.

$0.25 USDC

edit_exterior_surface

Apply exterior paint colors, material prompts, or multiple surface colors to a home image.

$0.25 USDC

Client Setup

Add the Streamable HTTP URL to an MCP client. Discovery requests are free. Paid tool calls return a 402 response with x402 payment terms when no payment header is present.

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

Generation Flow

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

Tool Input Notes

Exterior design

Send an `imageUrl` data URL or image URL, choose a `theme`, and optionally set `mode` to `exterior`, `garden`, or `custom`. Exterior mode is the default for HomeGPT.

Surface editing

Send an `imageUrl` plus `colorHex`, `materialPrompt`, or a `colors` array for multiple surfaces such as siding, trim, doors, or shutters.