Bir AI agent'ın bina dış cephelerini tasarlamasına, maliyet tahminleri oluşturmasına ve fotoğraflardan teknik dokümantasyon hazırlamasına olanak tanır.
Ayrıca bilinen adı getfacade/mcp, mcp, @getfacade/mcp
- Yıldızlar
- 1
- Araçlar
- 22
- İndirmeler, 30 gün
- 354
- En son sürüm
- 0.2.0
- Son commit
- 1 Eki 2026
- Lisans
- MIT
GetFacade MCP nedir?
Bir AI agent'ın bina dış cephelerini tasarlamasına, maliyet tahminleri oluşturmasına ve fotoğraflardan teknik dokümantasyon hazırlamasına olanak tanır. 22 araç sunar; örneğin create_building, upload_photo, list_photos.
Özet, projenin README dosyasından oluşturuldu
GetFacade MCP sunucusu hakkında
GetFacade, AI agent'ların bina dış cephe tasarımı ve dokümantasyon süreçlerini otomatikleştirmesi için bir arayüz sağlar. Kullanıcıların mevcut yapıların fotoğraflarını, binanın bulunduğu ülkeye özel yerel malzeme seçimleri ve üretici ürünleri içeren yeniden tasarlanmış cephelere dönüştürmesine imkan tanır. Sunucu, GetFacade API'si için ince bir sarmalayıcı (wrapper) görevi görerek fiyatlandırma, renk kuralları ve teknik kurallarla ilgili tüm mantığın servis tarafında kalmasını sağlar.
Geliştiriciler; Claude, ChatGPT veya Cursor gibi istemcilerde kullanmak üzere uzak bir HTTP URL'si üzerinden bağlanabilir veya Node.js ve bir agent API anahtarı kullanarak yerel olarak çalıştırabilirler. Sistem; create_building, upload_photo ve start_design gibi araçlar aracılığıyla karmaşık iş akışlarını yönetir. Render alma ve maliyet tahmini gibi asenkron görevleri bir iş sorgulama (job polling) sistemi üzerinden yürütür. Idempotency anahtarları kullandığı için sunucu, ücretli bir istek sırasında bağlantı kopması yaşanması durumunda yanlışlıkla mükerrer faturalandırma yapılmasını önler.
Kullanıcılar maliyetlerini bir agent cüzdanı üzerinden yönetebilir ve belirli harcama limitleri belirleyebilirler. Sunucu, inşaat ekipleri için satır satır detaylandırılmış tahminlere ve teknik PDF albümlerine erişim sağlarken, tamamlanan renderlar için kalıcı genel bağlantılar oluşturur.
Neler yapabilirsiniz
- 1Yerelleştirilmiş maliyet tahminiBir geliştirici, binanın konumuna özel malzeme ve işçilik maliyetlerinin detaylı dökümünü talep edebilir.
- 2Teknik inşaat dokümantasyonuBir agent, inşaat ekipleri için güvenlik notlarını ve teknik yapı detaylarını içeren bir PDF albümü oluşturabilir.
- 3Yinelemeli tasarım iyileştirmeKullanıcılar, mevcut bir mimari tasarımı değiştirmek için doğal dili kullanabilirler.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
GetFacade MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleGetFacade MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'GETFACADE_API_KEY=<YOUR_GETFACADE_API_KEY>' mcp -- npx -y @getfacade/mcpGetFacade MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@getfacade/mcp"
],
"env": {
"GETFACADE_API_KEY": "<YOUR_GETFACADE_API_KEY>"
}
}
}
}GetFacade MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getfacade/mcp"
],
"env": {
"GETFACADE_API_KEY": "<YOUR_GETFACADE_API_KEY>"
}
}
}
}GetFacade MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@getfacade/mcp"],"env":{"GETFACADE_API_KEY":"<YOUR_GETFACADE_API_KEY>"}}'GetFacade MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@getfacade/mcp"
],
"env": {
"GETFACADE_API_KEY": "<YOUR_GETFACADE_API_KEY>"
}
}
}
}GetFacade MCP'yi Codex içine yükleyin
$ codex mcp add mcp --env 'GETFACADE_API_KEY=<YOUR_GETFACADE_API_KEY>' -- npx -y @getfacade/mcpGetFacade MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@getfacade/mcp"] [mcp_servers.mcp.env] GETFACADE_API_KEY = "<YOUR_GETFACADE_API_KEY>"
GetFacade MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'GETFACADE_API_KEY=<YOUR_GETFACADE_API_KEY>' mcp npx -- -y @getfacade/mcpGetFacade MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@getfacade/mcp"
],
"env": {
"GETFACADE_API_KEY": "<YOUR_GETFACADE_API_KEY>"
}
}
}
}GetFacade MCP araçları 22
README dosyasından algılandıcreate_buildingupload_photolist_photosstart_designrefine_designget_joblist_jobslist_designsorder_estimateorder_albumupscale_renderget_estimate
| create_building | — | |
| upload_photo | — | |
| list_photos | — | |
| start_design | — | |
| refine_design | — | |
| get_job | — | |
| list_jobs | — | |
| list_designs | — | |
| order_estimate | — | |
| order_album | — | |
| upscale_render | — | |
| get_estimate | — |
22 aracın tümünü gösterDaha az araç göster
add_estimate_lineupdate_estimate_linedelete_estimate_linedelete_renderdelete_designdelete_buildinglist_token_packagesbuy_tokensget_balancereport_problem
| add_estimate_line | — | |
| update_estimate_line | — | |
| delete_estimate_line | — | |
| delete_render | — | |
| delete_design | — | |
| delete_building | — | |
| list_token_packages | — | |
| buy_tokens | — | |
| get_balance | — | |
| report_problem | — |
Yapılandırma
GETFACADE_API_KEYGerekliGizliAgent key issued at app.getfacade.ai under Account, Settings, API. Shown once.
GETFACADE_API_BASE_URLBase URL of the API. Leave unset to use the production one.
GETFACADE_LANGLanguage the service answers and refuses in. Leave unset for English.
| Ad | Açıklama | Sunucu |
|---|---|---|
| GETFACADE_API_KEY | Agent key issued at app.getfacade.ai under Account, Settings, API. Shown once. | GerekliGizli |
| GETFACADE_API_BASE_URL | Base URL of the API. Leave unset to use the production one. | |
| GETFACADE_LANG | Language the service answers and refuses in. Leave unset for English. |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirgetfacade/mcp is public and reachablegithub.com/getfacade/mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@getfacade/mcp names getfacade/mcp as sourcenpmjs.com/package/@getfacade/mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)Sigstore attestation for @getfacade/mcpnpmjs.com/package/@getfacade/mcp/v/0.2.0#provenance ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-01github.com/getfacade/mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @getfacade/mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok99 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok22 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
@getfacade/mcp
MCP server for GetFacade.ai: an agent creates a building, uploads a photo of it, gets the exterior designed, priced and documented, without a human in front of a screen.
Each design is worked out for the country the building stands in: materials that are applicable there, manufacturer products that are actually sold there, and the technical build-up behind the surface. The render shows that on the photo of the house.
The estimate and the album come from the same design:
- The estimate prices it line by line, in materials and labour, at what those materials cost in that country.
- The album documents it for the crew that builds it: the build-up of the facade, safety notes and the norms behind them.
The server is a thin wrapper over the public GetFacade API. It stores nothing, caches nothing and decides nothing: every rule (pricing, admission, the colour grammar, every message) stays on the server, and the wrapper only carries calls and answers.
Connect by URL
Most clients connect without installing anything. Add a custom connector with this URL and sign in to your GetFacade account when asked:
https://app.getfacade.ai/mcp
- Claude (claude.ai and desktop): Settings → Connectors → Add custom connector.
- Claude Code:
claude mcp add --transport http getfacade https://app.getfacade.ai/mcp - ChatGPT, Cursor, VS Code and other MCP clients: add a remote (HTTP) server with the same URL.
On the sign-in screen you set a spend cap for the connection. It spends tokens from the agent wallet of your account and never buys tokens on its own. The connection appears among your agent keys in the app, where it can be revoked at any time.
A photo attached to a chat has no link the connector can read. create_building returns
photos_page, the building's photo page in the app: add the photo there, and list_photos picks
it up. A direct public link to an image works with upload_photo as well.
Run locally
The package below runs the same tools on your own machine with an agent key. Use it for automation, or when the photos are files on that machine.
Requirements
- Node.js 20+
- An agent API key. Issue one for yourself at app.getfacade.ai → Account → Settings → API. The value is shown once and cannot be recovered; each key carries a hard spend cap.
- Agent access is paid. There are no trial credits in it: the key spends from the agent wallet, and without a balance the first paid call is refused with an explanation. An active Pro Plan fills that wallet up to 1,000 credits once per billing period; past that, credits are bought.
Setup
Claude Desktop / any MCP client, mcpServers section:
{
"mcpServers": {
"getfacade": {
"command": "npx",
"args": ["-y", "@getfacade/mcp"],
"env": { "GETFACADE_API_KEY": "your-key" }
}
}
}
To run a checkout instead of the published package, point the client at it:
"command": "node", "args": ["/path/to/mcp/src/index.js"].
| Variable | Required | Default |
|---|---|---|
GETFACADE_API_KEY |
yes | — |
GETFACADE_API_BASE_URL |
no | https://api.getfacade.ai/api/v1 |
GETFACADE_LANG |
no | en |
Messages, including refusals, come from the service in the language of
GETFACADE_LANG. Set it to the language the answer should be read in.
Tools
| Tool | What it does |
|---|---|
create_building |
Creates a building. The name is unique per account. Say where it stands, or the place is inferred from the connection the call arrives on. |
upload_photo |
Takes a file path (local) or an image link (URL connection). Registers the file, uploads the bytes, confirms, waits for the answer: a view to design from, a drawing or reference kept with the building, or a refusal with the reason. |
list_photos |
The views of a building, including photos added in the app. view_id is what start_design takes. |
start_design |
Creates a design and queues its render. Returns a job id. |
refine_design |
Changes a finished design in words. Every step after the first. |
get_job |
Polls one render, estimate or album. |
list_jobs |
Recent jobs across the account, unfinished first. |
list_designs |
Designs of a building with their renders and finished picture. |
order_estimate |
Orders a cost estimate for chosen renders. |
order_album |
Orders the PDF album for chosen renders. |
upscale_render |
Enlarges a finished render. Costs tokens, asynchronous. |
get_estimate |
The estimate itself: totals, assumptions and every line. |
add_estimate_line |
Adds one line to an estimate. |
update_estimate_line |
Edits one line of an estimate. |
delete_estimate_line |
Removes one line from an estimate. |
delete_render |
Deletes one render. The main render's design returns to draft. |
delete_design |
Deletes one design with the renders under it. |
delete_building |
Deletes a building with everything under it. |
list_token_packages |
The packages this account can buy. |
buy_tokens |
Refills this key's wallet. Local package only. See below. |
get_balance |
Agent wallet, key cap, and whether the next paid call will be accepted. |
report_problem |
Reports a defect in this API. Free, and works on an empty wallet. |
Rendering is asynchronous: start_design, refine_design, order_estimate and order_album return a job id
immediately, and get_job reports when it is done. A finished estimate reads ready where a
render and an album read completed. The only call that waits is upload_photo, which polls
until the answer is in.
A paid call is never ordered twice
start_design, refine_design, order_estimate, order_album and upscale_render cost
money, and the charge follows the job that gets created. If one of them times out, the honest
question is whether the job exists, and the agent cannot answer it from where it stands.
So this server answers it instead. Every paid call goes out under a name of its own
(Idempotency-Key), and this server, not the agent, retries it under that same name when the
connection fails or when the API says the first attempt is still running. The API recognises
the repeat and hands back the original job, so a timeout costs one design, not two.
Nothing about this reaches the tool arguments: ordering the same design twice on purpose stays possible, because two calls are two names. What is gone is the accidental second order.
The API requires that name on every paid call made with an API key, so calling it without this wrapper means sending the header yourself. The reference is at getfacade.ai/agents.
What the key can reach
A key is a bearer secret that lives in your agent's config, so its reach is the published agent
surface and nothing else: buildings, photos, designs, renders, estimates, albums, the jobs list
and the API wallet. Anything outside that answers 403 AGENT_SURFACE_FORBIDDEN, including the
account's own sign-in settings, its subscription and its payment history. Changing those, and
issuing or revoking keys, is done by a person signed in to the app.
The reference is at getfacade.ai/agents.
Results are permanent public links
A finished render (result_url, main_render_url) and a finished album (result_url) are
served from stable URLs: no signature, no expiry. An assistant can hand one straight to a
person as the answer to "show me the result", with nothing to refresh and no second call.
The honest half of that: because the link is unsigned it asks nobody for permission, so it
keeps working for whoever it is forwarded to, and it cannot be recalled afterwards. Share it as
deliberately as any other link that is public forever. GET /renders/{render}/download is a
different thing — a short-lived signed URL with a filename, for saving the file rather than for
sharing it.
Deletions are soft on the server: a person can undo them in the app, this server cannot.
buy_tokens works only if the key was issued with purchasing enabled (a switch on the
issue screen), and only up to what the key may still spend — a purchase never lifts the key's
own spend cap. It answers charged when the payment provider took it from a saved payment
method, or requires_human with a checkout_url for a person to open. Either way the tokens
are credited when the payment is confirmed, so poll get_balance.
Issuing keys and buying a subscription are deliberately absent: a key that can issue itself a key has no ceiling, and a subscription is bought by a person, in the app.
License
MIT (see LICENSE) — this wrapper carries calls and answers and nothing else, so there is
nothing in it to keep closed. The GetFacade service it talks to is a separate matter: using it
is governed by the terms at getfacade.ai/terms, and a key is
issued to an account, not to this package.
Development
npm install
npm test # smoke test against a stub of the API
test/live-journey.mjs drives the whole journey through a real MCP client against a real API
with a real key. It is not part of npm test, because it spends actual credits; the header of
the file says how to run it.
Releases: see RELEASING.md.
GetFacade MCP soruları
GetFacade MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'GETFACADE_API_KEY=<YOUR_GETFACADE_API_KEY>' mcp -- npx -y @getfacade/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
GetFacade MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
GetFacade MCP hangi araçları sunar?
22 araç sunar; bunlar arasında create_building, upload_photo, list_photos, start_design, refine_design yer alır.
GetFacade'e nasıl bağlanabilirim?
Claude veya ChatGPT gibi istemcilerde özel bir URL aracılığıyla bağlanabilir ya da bir agent API anahtarı kullanarak yerel olarak çalıştırabilirsiniz.
Bir fotoğrafı doğrudan sohbet içinde kullanabilir miyim?
Sohbete doğrudan eklenen fotoğraflar konektör tarafından okunamaz; fotoğrafları araç aracılığıyla yüklemeli veya uygulamanın bina fotoğraf sayfasına eklemelisiniz.