HostBase

HostBase for AI agents

Connect your agent. Build anything.

One MCP server and your agent — Claude Code, Codex, Cursor, Antigravity, Hermes — has Postgres databases, workers, sites, sandboxes, email and an AI gateway at hand. Describe what should exist; the agent creates, deploys and checks the logs.

Connect your agent Create an account
170+
MCP tools
16
ready-made clients
OAuth 2.1
or a PAT token
EU
data in Warsaw
terminal — agent with HostBase MCP170+ MCP tools
  1. Build a shop with a cart on Next.js and Postgres, deploy it and give me the link.
  2. Plan: project with a database → schema with RLS → mail worker → site.
  3. create_project({ name: "shop", region: "pl-waw-1" })
  4. project k3x9qz7mwa2c · active · Postgres 17
  5. execute_sql({ ref: "k3x9qz…", query: "create table products …; create table cart_items …" })
  6. CREATE TABLE ×4 · RLS enabled · 12 products (seed)
  7. deploy_worker({ name: "order-mailer", type: "queue", runtime: "node22" })
  8. build ok · v1 active · pgmq queue attached
  9. set_site_env({ name: "shop", env: { NEXT_PUBLIC_SUPABASE_URL: "…" } })
  10. 3 variables saved
  11. deploy_site({ name: "shop", mode: "source", target: "production" })
  12. deployment d1 · next build 38 s
  13. get_site_logs({ name: "shop", build: true })
  14. 14 routes · 0 errors · healthcheck 200
  15. Done. The shop is live and the cart persists in Postgres:
  16. https://shop-k3x9qz7m.host.ulewicz.space
example session

Example session — tool names are real, identifiers and URLs are illustrative.

Ready-made setups for agents and editors

How it works

Connect → Describe → Deploy

  1. 01

    Connect

    Add the MCP server with one command, an “Add to Cursor” link or a config entry. Sign in with OAuth or provide a token.

    claude mcp add --transport http hostbase …

  2. 02

    Describe

    Say what should exist: a shop, an API, a report, a bot. The agent picks HostBase tools and plans the steps.

    ❯ stand up an API with an order queue…

  3. 03

    Deploy

    The agent creates the project, runs migrations, deploys the worker and site, sets env vars and reads logs. You get an HTTPS URL.

    https://api-k3x9….host.ulewicz.space

Setup

Pick a client, copy, done.

Each set is exactly the configuration that client expects. Choose OAuth (no secrets in files) or a PAT. The badge on each client tells you how closely the snippet matches the vendor's documentation.

Claude Code

Transport: Streamable HTTP (native)

Matches vendor docsClient documentation
Authentication

Recommended: no secrets to copy, you approve the scopes on the consent screen.

Add the server
claude mcp add --transport http hostbase https://host.ulewicz.space/api/mcp
Sign in (inside Claude Code)
/mcp

Pick hostbase in /mcp and approve the scopes in your browser (OAuth 2.1).

One-liner with the HostBase CLI:hostbase mcp install --client claude-code

What the agent can do

174 tools, grouped by product.

This list is generated from the MCP server code, so it always matches what your agent will actually see. A token with limited scopes only sees the tools it may call.

Organizations and projects 25Postgres 19Edge Functions and secrets 8Workers 31Sites 27Sandboxes 7One-click apps (60) 7Email 6AI Gateway 13Traffic, WAF and network 14Feature Flags and config-as-code 5Monitoring, costs and limits 12
Organizations and projects25 tools
  • list_organizations

    Lista organizacji HostBase, do których należy użytkownik.

  • list_projects

    Lista wszystkich projektów (baz danych) użytkownika we wszystkich organizacjach.

  • get_project

    Szczegóły projektu: status, region, rozmiar instancji, URL API.

  • create_project

    Tworzy nowy projekt Postgres/Supabase w wybranej organizacji i regionie.

  • get_project_keys

    Zwraca URL API i publiczny klucz anon projektu.

  • pause_project

    Wstrzymuje aktywny projekt (wymaga roli owner/admin).

  • restore_project

    Wznawia wstrzymany projekt (wymaga roli owner/admin).

  • delete_project

    Trwale usuwa projekt wraz z bazą danych, plikami i funkcjami (wymaga roli owner/admin).

  • list_custom_domains

    Własne domeny API projektu ze statusem certyfikatu (pending/active/error) i stanem rekordu DNS (CNAME → <ref>.host.ulewicz.space).

  • add_custom_domain

    Dodaje własną domenę API (np.

  • remove_custom_domain

    Usuwa własną domenę z projektu (routing i certyfikat).

  • move_project

    Przenosi projekt do innego regionu (ten sam ref, URL i klucze).

  • get_move_status

    Stan ostatniego przenoszenia projektu między regionami: krok, błąd, ostrzeżenia, czasy.

  • list_templates

    Szablony projektów (SaaS multi-tenant, blog/CMS, sklep, czat AI z RAG, czat Realtime, lista zadań): tabele, funkcje SQL, Edge Functions, buckety i wy…

  • apply_template

    Stosuje szablon w aktywnym projekcie: rozszerzenia, migracje (historia supabase_migrations), Storage/Realtime, Edge Functions.

  • get_import_status

    Stan ostatniego importu z Supabase/Postgresa do projektu: krok, postęp, log, błąd.

  • list_toolsets

    Pokazuje grupy narzędzi (toolsets) tego serwera MCP i które są teraz aktywne.

  • create_upload

    Tworzy jednorazowy, ważny 15 minut adres do wysłania lokalnych plików (tar.gz lub zip, do 24 MB) bez przepuszczania ich przez kontekst modelu.

  • search_docs

    Przeszukuje dokumentację HostBase (strony docs + llms.txt) i zwraca najtrafniejsze fragmenty z linkami.

  • get_project_context

    Zestaw informacji do ugruntowania agenta o projekcie w jednym wywołaniu: adresy (API, Studio), publiczny klucz anon, schemat (tabele i kolumny), Edge…

  • generate_types

    Generuje typy TypeScript (zgodne z `supabase gen types typescript`) z aktualnego schematu bazy.

  • get_logs

    Logi z jednego miejsca: service = db | auth | rest | realtime | storage | functions | api-gw | meta (stos Supabase) albo site | worker | app (wymaga…

  • run_sql

    Wykonuje SQL na bazie projektu.

  • list_migrations

    Historia migracji projektu (supabase_migrations.schema_migrations): wersja, nazwa, liczba instrukcji.

  • apply_migration

    Stosuje migrację SQL atomowo (jedna transakcja) i zapisuje ją w historii.

Postgres — branches, PITR, replicas, upgrades19 tools
  • execute_sql

    Wykonuje zapytanie SQL na bazie Postgres projektu (wymaga roli owner/admin/developer).

  • list_branches

    Gałęzie bazy projektu: main (produkcja) i gałęzie podglądowe ze statusem, trybem (schema/data) i URL API.

  • create_branch

    Tworzy gałąź bazy z main projektu: osobny stos Supabase z własnym URL i kluczami.

  • delete_branch

    Usuwa gałąź (ref lub nazwa) razem z jej bazą.

  • merge_branch

    Scala gałąź do main: wykonuje w main (w jednej transakcji) migracje z supabase_migrations.schema_migrations gałęzi, których main nie ma.

  • get_pitr

    Stan point-in-time recovery projektu: włączone, retencja, okno przywracania (UTC), rozmiar archiwum WAL, backupy bazowe.

  • restore_pitr

    Przywraca CAŁĄ bazę projektu do wskazanego momentu (ISO 8601, w oknie z get_pitr).

  • list_replicas

    Repliki odczytu projektu: region, status, adresy (REST, Postgres) i opóźnienie replikacji (lag).

  • create_replica

    Tworzy replikę odczytu projektu (strumieniowa replikacja Postgresa) w wybranym regionie.

  • delete_replica

    Usuwa replikę odczytu (stack, DNS i slot replikacji na projekcie głównym).

  • get_autoscaling

    Ustawienia autoskalowania compute projektu (min/max rozmiar, cooldown, reguły) i historia zmian rozmiaru.

  • set_autoscaling

    Włącza/wyłącza autoskalowanie compute w granicach min_size..max_size.

  • import_from_supabase

    Importuje bazę z Supabase (lub dowolnego Postgresa) do PUSTEGO projektu HostBase: schemat, dane, opcjonalnie użytkownicy Auth i pliki Storage (przez…

  • get_postgres_version

    Bieżąca wersja Postgresa projektu (obraz, wersja serwera, rozszerzenia), dostępne wersje docelowe (poprawki, wersja główna 15→17, wariant hb1), zapla…

  • check_postgres_upgrade

    Raport zgodności przed aktualizacją Postgresa (nic nie zmienia): dostępność rozszerzeń, typy reg*, tabele UNLOGGED, repliki, miejsce na dysku, szacow…

  • upgrade_postgres

    Aktualizuje Postgresa projektu do wersji `to`.

  • cancel_postgres_upgrade

    Anuluje zaplanowaną (jeszcze nierozpoczętą) aktualizację Postgresa.

  • confirm_postgres_upgrade

    Potwierdza zakończoną aktualizację główną: usuwa stary katalog danych (po tym nie można już wycofać).

  • rollback_postgres_upgrade

    Wycofuje niepotwierdzoną aktualizację główną do poprzedniego katalogu danych.

Edge Functions and secrets8 tools
  • list_edge_functions

    Lista Edge Functions projektu (nazwa, wersja, verify_jwt, adres URL).

  • get_edge_function

    Zwraca kod źródłowy (pliki) i konfigurację Edge Function.

  • deploy_edge_function

    Tworzy lub aktualizuje Edge Function (Deno, TypeScript).

  • delete_edge_function

    Usuwa Edge Function (wymaga roli owner/admin/developer).

  • list_function_secrets

    Lista nazw sekretów Edge Functions projektu (wartości nie są zwracane).

  • set_function_secrets

    Ustawia sekrety (zmienne środowiskowe) Edge Functions, np.

  • list_edge_function_versions

    Historia wdrożeń Edge Function: numer wersji, data, autor, opis zmiany, rozmiar.

  • rollback_edge_function

    Przywraca kod wskazanej wersji Edge Function (wdraża go jako nową wersję).

Workers — backends and jobs31 tools
  • list_workers

    Lista workerów projektu (ciężkie, długo działające kontenery): status, typ, środowisko, rozmiar, repliki, adres.

  • get_worker

    Szczegóły workera: status, wersje (build/aktywna), ostatnie uruchomienia (cron), zmienne środowiskowe.

  • deploy_worker

    Tworzy lub aktualizuje workera i buduje jego obraz (asynchronicznie — sprawdź status przez get_worker, błędy budowania przez get_worker_logs z build=…

  • list_worker_templates

    Galeria gotowych szablonów workerów (FastAPI, Stripe webhook, OCR, scraper Playwright, boty, Rust Axum, Spring Boot, Laravel, Rails, .NET, ...).

  • deploy_worker_template

    Wdraża gotowy szablon workera jako nowy worker (jedno wywołanie).

  • move_worker

    Przenosi workera między serwerem bazodanowym (local) a dedykowanym serwerem workerów (dedicated) bez przerwy (nowa instancja jest budowana i sprawdza…

  • worker_action

    Steruje workerem: start, stop, restart, run (cron — uruchom teraz), scale (replicas 0-10; autoskalowanie przez workers_scale), activate (version — pr…

  • get_worker_logs

    Logi workera (stdout/stderr wszystkich replik, najnowsze na końcu).

  • delete_worker

    Usuwa workera (kontenery, obrazy i adres).

  • workers_scale

    Skaluje workera.

  • worker_config_set

    Zmienia konfigurację workera bez przebudowy: health ({type: http|tcp|command|none, path, command, interval_s, timeout_s, failures, start_period_s}),…

  • worker_jobs_run

    Uruchamia jednorazowe zadanie na obrazie workera (migracja, backfill, raport).

  • worker_jobs_list

    Historia zadań workera (name) albo całego projektu (bez name): status, próba, kod wyjścia, czas.

  • worker_job_logs

    Logi zadania workera (zachowane po zakończeniu).

  • worker_volume_set

    Tworzy lub powiększa trwały wolumen workera (1-50 GB) zamontowany w /data.

  • worker_volume_delete

    Usuwa wolumen workera razem z danymi (nieodwracalne).

  • worker_events

    Dziennik zdarzeń workera: skalowanie, wybudzenia, zimne starty (ms), OOM, restarty, zadania.

  • worker_generate

    Generuje (bez wdrażania) workera z opisu w języku naturalnym: kod, zależności, schemat zmiennych env i testy, w wybranym środowisku.

  • worker_db_trigger_create

    Tworzy trigger bazodanowy: zdarzenia INSERT/UPDATE/DELETE na tabeli trafiają do kolejki pgmq (tworzonej w razie potrzeby), z której czyta worker typu…

  • list_worker_db_triggers

    Lista triggerów bazodanowych utworzonych przez Workers (prefiks hb_wt_): tabela, kolejka, definicja.

  • worker_db_trigger_delete

    Usuwa trigger bazodanowy Workers (name musi zaczynać się od hb_wt_) razem z jego funkcją.

  • worker_workflows

    Trwałe workflowy na Postgresie (schemat hostbase_workflows, kolejka pgmq hb_workflows; wykonuje je worker z SDK - szablony workflows-node / workflows…

  • list_worker_workflow_runs

    Przebiegi trwałych workflowów (status, kroki).

  • get_worker_insights

    Inteligentne sugestie dla workerów projektu: zmiana rozmiaru, scale-to-zero i redukcja replik z szacunkiem oszczędności (zł/mies.), przyczyny pętli r…

  • workers_deploy_image

    Wdraża gotowy obraz Docker (Docker Hub, GHCR, dowolny rejestr) jako workera — bez budowania.

  • get_worker_image_info

    Pobiera obraz na serwer danych (opcjonalnie z danymi logowania do rejestru) i zwraca rozmiar, wystawione porty, użytkownika, entrypoint i ostrzeżenia.

  • workers_import

    Konwertuje definicję usługi z innej platformy na workera: Procfile + app.json (Heroku/Dokku), render.yaml, railway.json/toml, fly.toml, docker-compos…

  • workers_deploy_git_url

    Tworzy workera z publicznego repozytorium Git (github.com, gitlab.com, bitbucket.org, codeberg.org) — pobiera archiwum wskazanej gałęzi/tagu i podkat…

  • workers_git_link

    Łączy workera z repozytorium GitHub projektu (Integracje → GitHub): push do gałęzi wdraża nową wersję, PR dostaje własny worker podglądowy <worker>-p…

  • workers_transfer

    Przenosi workera: do innego projektu tej samej organizacji (target_ref; kopiuje kod, konfigurację i zmienne, zwraca raport co skopiowano i co wymaga…

  • workers_replay

    Przechwytywanie i odtwarzanie żądań workera HTTP.

Sites — websites and web apps27 tools
  • site_automation

    Konfiguracja automatyzacji witryny (jak hostbase.json): pipeline (preBuild, postBuild, preDeploy, postDeploy z krokami smoke/sql/script/webhook, cach…

  • site_env_groups

    Grupy zmiennych środowiskowych witryny (production, preview, development; wartości sekretne są maskowane).

  • site_pipeline_runs

    Przebiegi potoku wdrożeniowego witryny (kroki: build, kontrole, pre-deploy, promocja, smoke po wdrożeniu, nadzór 5xx, rollback).

  • site_scripts

    Skrypty witryny uruchamiane w obrazie budowania (np.

  • site_checks

    Kontrole jakości wdrożenia: Lighthouse (wydajność, dostępność, SEO, dobre praktyki), zrzut ekranu i różnice wizualne vs produkcja (pixelmatch).

  • site_rum

    Opcjonalny znacznik Web Vitals (RUM) witryny: action=get zwraca fragment <script>, set (enabled) włącza lub wyłącza zbieranie LCP/CLS/INP/FCP/TTFB.

  • site_platform

    Konfiguracja platformy witryny (v23): protection {mode none|password|sso, scope previews|all, password}, maintenance {enabled,title,message,retry_aft…

  • site_rules_test

    Tester reguł witryny: co zrobi bramka dla żądania {url, country?, device?, cookies?, headers?, random?, config?}.

  • site_freeze

    Zamrożenie wdrożeń produkcyjnych witryny (rollback nadal działa).

  • site_notifications

    Powiadomienia i alerty witryny: notify_ready/failed/promoted/comments, bw_limit_gb, revalidate_url/secret.

  • site_comments

    Komentarze przypięte w podglądach witryny.

  • site_revalidate

    Rewalidacja na żądanie (ISR / CDN): paths ["/blog"], tags, all.

  • site_import

    Migracja z Vercel / Netlify / Cloudflare Pages.

  • site_cutover

    Instrukcja przełączenia DNS dla domen witryny (rekordy do ustawienia, aktualny stan, status TLS) — po imporcie lub przeniesieniu.

  • site_move

    Przenieś witrynę do innego projektu / regionu (np.

  • list_sites

    Lista witryn projektu (Sites): status, typ (static/ssr), framework, adres produkcyjny <witryna>-<ref>.host.ulewicz.space, domeny i ostatnie wdrożenia.

  • get_site

    Szczegóły witryny: ustawienia, zmienne środowiskowe, domeny oraz lista wdrożeń (id dN, status, cel production/preview, adres podglądu, błąd).

  • deploy_site

    Tworzy wdrożenie witryny (asynchronicznie — sprawdzaj get_site, błędy przez get_site_logs z build=true).

  • promote_site_deployment

    Ustawia wdrożenie jako produkcyjne (awans podglądu albo natychmiastowy rollback do starszego wdrożenia dN).

  • site_action

    Akcje witryny: redeploy (przebuduj ostatni kod z aktualnymi zmiennymi), restart (SSR), delete_deployment (deployment=dN), wake (obudź uśpiony podgląd…

  • get_site_logs

    Logi witryny: build=true zwraca log budowania wdrożenia (deployment=dN, domyślnie najnowsze); inaczej logi działającej aplikacji SSR.

  • set_site_env

    Zastępuje zmienne środowiskowe witryny ({NAZWA: wartość}).

  • site_domains

    Własne domeny witryny: action=list|add|remove (hostname).

  • site_cdn

    CDN witryny (Cloudflare proxy, pomarańczowa chmurka): action=status (domyślnie)|enable|disable|purge|analytics.

  • get_site_analytics

    Statystyki witryny z logów dostępu: żądania, transfer, kody statusu, najpopularniejsze strony i zasoby.

  • site_deploy_hook

    Hook wdrożeniowy witryny (URL do wywołania POST z CI/CMS): action=get (domyślnie), create (utwórz lub zrotuj), delete.

  • delete_site

    Usuwa witrynę wraz ze wszystkimi wdrożeniami, domenami i hookiem.

Sandboxes — run code7 tools
  • create_sandbox

    Tworzy izolowany sandbox (microVM Kata/Cloud Hypervisor, opcjonalnie gVisor) do bezpiecznego wykonywania kodu.

  • list_sandboxes

    Lista sandboxów projektu (stan, szablon, zasoby, czas wygaśnięcia).

  • sandbox_exec

    Wykonuje polecenie powłoki w sandboxie (bash -c) i zwraca exit_code, stdout i stderr.

  • sandbox_run_code

    Uruchamia fragment kodu w sandboxie jak komórkę Jupytera.

  • sandbox_write_file

    Zapisuje plik w sandboxie (tworzy katalogi).

  • sandbox_read_file

    Odczytuje plik z sandboxa jako tekst UTF-8 (do 200 kB; większe są obcięte).

  • close_sandbox

    Zamyka sandbox i usuwa jego maszynę, dysk i sieć (kończy naliczanie opłat).

One-click apps (60)7 tools
  • list_app_catalog

    Katalog ~60 aplikacji 1-klik (autoinstalatory) w 14 kategoriach (BI, CMS, wiki, Git, auth, AI, CRM…): cena PLN/mies., RAM, licencja, popularność i li…

  • list_apps

    Aplikacje 1-klik zainstalowane w projekcie: status, wersja, adres HTTPS, host, cena, rola bazy.

  • get_app

    Szczegóły zainstalowanej aplikacji 1-klik (status, wersje do aktualizacji, licencja, rola bazy).

  • install_app

    Instaluje aplikację 1-klik w projekcie (kontener pod https://<app>-<ref>.host.ulewicz.space, połączony z Postgresem projektu rolą o minimalnych upraw…

  • app_action

    Steruje aplikacją 1-klik: start, stop, restart, upgrade (version — aktualizacja/zmiana przypiętej wersji).

  • get_app_logs

    Logi kontenerów aplikacji 1-klik (najnowsze na końcu).

  • remove_app

    Usuwa aplikację 1-klik: kontenery, rola i schemat w bazie oraz dane aplikacji.

Email6 tools
  • get_email_overview

    Usługa Email projektu: wysłane/dostarczone/zwroty z 30 dni, wykorzystanie limitu dziennego i miesięcznego planu, stan reputacji (ok/warning/critical).

  • list_email_domains

    Domeny nadawcy Email z rekordami DNS (DKIM, SPF, return-path, DMARC) i ich stanem weryfikacji.

  • add_email_domain

    Dodaje domenę nadawcy (generuje klucz DKIM) i zwraca rekordy DNS do opublikowania.

  • verify_email_domain

    Sprawdza w DNS rekordy domeny nadawcy i aktualizuje jej status.

  • list_email_messages

    Ostatnie wiadomości wysłane przez usługę Email (status, odbiorcy, temat).

  • list_email_suppressions

    Lista wyłączeń Email: adresy pomijane przy wysyłce (twarde zwroty, skargi, ręczne).

AI Gateway13 tools
  • get_ai_gateway

    AI Gateway projektu: adres bramki zgodnej z OpenAI (base_url), skonfigurowani dostawcy (klucze nigdy nie są zwracane), liczba kluczy, ustawienia (cac…

  • get_ai_gateway_usage

    Zużycie AI Gateway: żądania, tokeny, szacowany koszt, p50/p95, cache hit-rate, błędy wg dostawcy i modelu.

  • list_ai_gateway_keys

    Klucze bramki AI (prefiks, zakresy, limit rpm, budżet, wydatki w miesiącu).

  • create_ai_gateway_key

    Tworzy klucz bramki AI (hbai_…).

  • revoke_ai_gateway_key

    Unieważnia klucz bramki AI (natychmiast przestaje działać).

  • set_ai_provider

    Konfiguruje dostawcę LLM (BYOK) dla bramki AI: kind = anthropic | openai | mistral | custom (OpenAI-compatible, wymaga base_url i models) | mock.

  • delete_ai_provider

    Usuwa dostawcę z bramki AI (wraz z zaszyfrowanym kluczem).

  • set_ai_gateway_settings

    Ustawienia bramki AI: pii (redakcja PESEL/e-mail/telefon), cache_ttl_seconds (0 = wyłączony), retention_days, log_bodies, budget_usd (miesięczny budż…

  • list_ai_gateway_evals

    Evals AI Gateway: zestawy przypadków testowych i ostatnie uruchomienia (porównanie modeli: jakość, koszt, opóźnienie).

  • create_ai_gateway_eval_set

    Tworzy/aktualizuje zestaw evals.

  • run_ai_gateway_eval

    Uruchamia eval w tle na wielu modelach (zużywa tokeny u Twoich dostawców BYOK).

  • get_ai_gateway_eval_run

    Wynik uruchomienia evals: status/postęp, podsumowanie per model (średnia ocena, zaliczone, opóźnienia, koszt) oraz wyniki per przypadek.

  • get_ai_gateway_end_users

    Zużycie AI Gateway per użytkownik końcowy (nagłówek x-hb-user) w tym miesiącu: żądania, tokeny, szacowany koszt.

Traffic, WAF and network14 tools
  • get_traffic

    Ruch projektu z logu dostępowego brzegu: żądania, klasy statusów, bajty, opóźnienia p50/p95/p99 per usługa (rest/auth/storage/realtime/functions/api,…

  • get_waf

    Konfiguracja zapory WAF projektu (Coraza + OWASP CRS): mode (off | detect | block), paranoia 1-4, wyjątki reguł per ścieżka, reguły własne (IP/CIDR,…

  • set_waf

    Zmienia ustawienia WAF (scalane z bieżącymi — podaj tylko to, co zmieniasz).

  • list_waf_events

    Ostatnie zdarzenia WAF (id reguły, komunikat, zredagowane dopasowane dane, IP, ścieżka, akcja blocked/detected/limited/banned).

  • get_waf_stats

    Statystyki WAF: serie czasowe (żądania, zablokowane, wykryte, limity, bany), top reguły / adresy IP / ścieżki.

  • list_waf_bans

    Aktywne bany adresów IP (automatyczne po wielu nieudanych logowaniach oraz ręczne).

  • ban_ip

    Ręcznie banuje adres IP w projekcie (blokuje całe API) na duration_s sekund (domyślnie 3600).

  • unban_ip

    Zdejmuje ban z adresu IP (także automatyczny po nieudanych logowaniach).

  • get_static_egress

    Statyczny adres IP ruchu wychodzącego projektu (Edge Functions, pg_net, Workers) — do allowlist u partnerów.

  • set_static_egress

    Włącza/wyłącza dedykowany statyczny adres IP ruchu wychodzącego projektu (płatny dodatek, plan Pro+).

  • get_network_restrictions

    Lista adresów IP/CIDR, z których wolno łączyć się bezpośrednio z Postgresem (:5432) i poolerem (:6543).

  • set_network_restrictions

    Zastępuje listę dozwolonych adresów (IPv4/IPv6, CIDR; maks.

  • get_rate_limits

    Reguły limitów żądań w bramce API projektu: path_prefix (/rest/v1, /auth/v1/token…), rps (tempo), burst (zapas), scope (ip | global).

  • set_rate_limits

    Zastępuje wszystkie reguły limitów API (maks.

Feature Flags and config-as-code5 tools
  • list_feature_flags

    Lista Feature Flags projektu wraz ze stanem w środowiskach (production, staging, development).

  • get_feature_flag

    Pełna definicja flagi: warianty, reguły (atrybuty, wdrożenia procentowe) i konfiguracja każdego środowiska.

  • set_feature_flag

    Włącza lub wyłącza flagę w wybranym środowisku (kill-switch).

  • config_plan

    Config-as-code: porównuje obiekt konfiguracji (jak z hostbase.config.ts: autoscaling, network, rateLimits, domains, secrets, functions, workers, feat…

  • config_apply

    Config-as-code: stosuje konfigurację (najpierw wywołaj config_plan i pokaż plan użytkownikowi).

Monitoring, costs and limits12 tools
  • list_issues

    Błędy z Edge Functions i Workerów zgrupowane według odcisku (typ, komunikat, stack).

  • get_issue

    Szczegóły issue: stack trace, ostatnie wystąpienia i agent_context — gotowy brief w markdown (stack, logi, ostatni deploy) do naprawy przez agenta.

  • set_issue_status

    Zmienia status issue: resolved (wraca jako open, jeśli błąd się powtórzy), ignored albo open.

  • list_monitors

    Syntetyczne monitory HTTP projektu: stan, dostępność, pozostały budżet błędów SLO, p95 czasu odpowiedzi.

  • create_monitor

    Tworzy monitor HTTP (interwał 60/300/900/1800/3600 s, oczekiwany status np.

  • delete_monitor

    Usuwa monitor HTTP wraz z historią sprawdzeń.

  • get_runtime_advisors

    Health Check Advisors na żywo: odsetek 5xx API, saturacja połączeń, lag replik, zapełnienie dysku, nieudane kopie — z poziomem severity.

  • get_org_costs

    Eksplorator kosztów organizacji (PLN netto): koszt per usługa / projekt / dzień, prognoza na koniec miesiąca, porównanie z poprzednim miesiącem.

  • get_org_credits

    Saldo kredytów prepaid organizacji (PLN brutto): pule, daty wygaśnięcia i ostatnie operacje księgi.

  • list_spend_limits

    Limity wydatków organizacji i projektów wraz ze zużyciem (alerty 50/80/100%).

  • set_spend_limit

    Ustawia miesięczny limit wydatków (PLN netto) dla organizacji lub projektu.

  • delete_spend_limit

    Usuwa limit wydatków organizacji (bez project) lub wskazanego projektu.

Descriptions come from the MCP server and are written in Polish — your agent translates them into the language of your chat.

Prompt gallery

Copy. Paste into your agent. Watch it work.

Good prompts to start with. Under each one you can see the MCP tools the agent will use.

  • Build a shop with a cart on Next.js and Postgres, deploy it and give me the link.

    create_projectexecute_sqlset_site_envdeploy_siteget_site_logs

  • Add Google sign-in to my app and tell me what to paste into the dashboard.

    get_project_keysset_site_envdeploy_site

  • Make a landing page for my company with a contact form that stores leads in the database, and attach the domain my-company.com.

    deploy_siteexecute_sqlsite_domains

  • Set up a worker that builds a PDF order report every night and emails it.

    deploy_workerworker_config_setadd_email_domainworker_jobs_runget_worker_logs

  • Build RAG over my PDFs: I upload files and the chat answers with citations.

    execute_sqldeploy_workerdeploy_edge_functioncreate_ai_gateway_keyset_function_secrets

  • Add a Stripe webhook that flips the order status after payment and sends a confirmation.

    list_worker_templatesdeploy_worker_templateset_function_secretsexecute_sql

  • Test this migration on a database branch and, if it passes, merge it to production.

    create_branchexecute_sqlmerge_branch

  • Move my Supabase project to HostBase and verify that the data matches.

    import_from_supabaseget_import_statusexecute_sql

  • Install Metabase connected to my database and build a sales dashboard.

    list_app_cataloginstall_appexecute_sql

  • Write and run a Python script that cleans this CSV, in a sandbox and not on my machine.

    create_sandboxsandbox_write_filesandbox_run_codesandbox_read_fileclose_sandbox

  • Make a chatbot on an Edge Function with an AI Gateway key and a monthly budget cap.

    create_ai_gateway_keyset_ai_gateway_settingsdeploy_edge_functionset_function_secrets

  • Ship the new version behind a feature flag, enabled for 10% of users first.

    set_feature_flagdeploy_siteget_site_analytics

  • Why is the site slow? Look at the logs and advisors, then propose a fix.

    get_site_logsget_runtime_advisorslist_issuesget_worker_logs

  • Block bots probing /wp-admin and set a rate limit on the API.

    set_waflist_waf_eventsban_ipset_rate_limits

  • Someone dropped a table at 14:32 — restore the database to 14:31.

    get_pitrrestore_pitr

Security

The agent gets exactly what you give it.

You are handing an agent a shell and deploy rights, so control is part of the product: scopes, roles, limited tokens and code isolation.

Scoped tokens

A PAT with the “AI agent” preset (no project deletion, backup restore or key rotation) or a custom permission set. Pin a token to one organization or one project and set an expiry.

OAuth 2.1 and a consent screen

Clients register dynamically (DCR); you see the list of scopes and approve them in the browser. Revoke access with one click.

Per-project roles

An agent cannot bypass roles: owner, admin, developer. SQL, deploys and deletions are checked against the token owner's role.

Read-only mode

The “Read only” preset and *:read scopes give the agent a view of projects, logs and metrics with no right to change anything. Ideal for diagnosis.

Audit log

Token creation and revocation, and every access denial for an agent (scope, role, IP address), land in the organization audit log.

Sandboxes for code

Code you do not know is run by the agent in an isolated Sandbox, not on your machine or in the database. Resource and time limits are built in.

OAuth scopes approved when you connect22
  • projects:read — Odczyt projektów, organizacji, ustawień (sieć, domeny, PITR, skalowanie)
  • projects:write — Tworzenie, wstrzymywanie, usuwanie i konfiguracja projektów, klucze API
  • db:read — Odczyt danych SQL (tylko SELECT), migracje i typy - bez zapisu
  • db:write — Wykonywanie zapytań SQL na bazie projektu (odczyt i zapis)
  • sites:read — Odczyt Sites (lista, wdrożenia, logi)
  • sites:write — Wdrażanie i konfiguracja Sites (pliki z terminala, zmienne, domeny)
  • functions:read — Odczyt Edge Functions i listy sekretów
  • functions:deploy — Wdrażanie, wycofywanie i usuwanie funkcji; ustawianie sekretów
  • workers:read — Odczyt Workers i ich logów
  • workers:write — Wdrażanie, skalowanie i sterowanie Workers
  • branches:read — Odczyt gałęzi bazy danych
  • branches:write — Tworzenie, scalanie i usuwanie gałęzi
  • email:read — Odczyt modułu Email
  • email:write — Konfiguracja domen Email
  • ai:read — Odczyt AI Gateway i zużycia
  • ai:write — Zarządzanie kluczami i dostawcami AI Gateway
  • sandboxes:read — Odczyt Sandboxes (lista, metryki, logi)
  • sandboxes:write — Uruchamianie kodu w izolowanych Sandboxes (exec, pliki, terminal)
  • flags:read — Odczyt Feature Flags
  • flags:write — Zmiana Feature Flags
  • config:read — Podgląd planu config-as-code
  • config:write — Zastosowanie config-as-code

Skills and AGENTS.md

Teach your agent HostBase once, in the repo.

The CLI writes a skill for Claude Code, a Cursor rule and a block in AGENTS.md (Codex and others) into your project, with the project ref, commands and good practices. The agent starts with context.

The CLI writes config for Claude Code, Cursor and Codex. Configure the other clients with the snippets above.

Agents and config-as-code docs
hostbase CLI
hostbase mcp install     # MCP config: Claude Code, Cursor, Codex
hostbase skills install  # SKILL.md, Cursor rule, AGENTS.md block
hostbase init            # AGENTS.md + CLAUDE.md with the project ref

For machines

FAQ

Questions about agents and MCP

Does my agent need to support MCP?
Yes, but nearly every modern agent does. For the rest there is the Management API (OpenAPI) and llms.txt.
OAuth or a PAT?
OAuth is more convenient and safer: no secrets in files, consent on a screen. Pick a PAT in CI, on servers without a browser, or when the client lacks OAuth for remote servers.
Can an agent delete my database?
Only if you allow it. The “AI agent” preset has no project deletion, and delete_project also requires the exact project name. Use read-only mode for diagnosis.
Where does the code an agent writes run?
Sites for websites, Workers for backends, Edge Functions for functions and Sandboxes for ad-hoc scripts. All inside your project, in the EU.
How much does it cost?
The MCP server is free on every plan. You pay for the resources the agent starts (project, worker, apps), as per the pricing page.
My client has no tab here.
Any MCP client that speaks Streamable HTTP connects with the server URL and an Authorization header. If a client only knows stdio, use the npx mcp-remote bridge.

Create an account, create a token, connect your agent.

Three steps and the first agent-driven deployment in minutes. No credit card.

Start a project Talk to us