Impreza Host
No-KYC offshore hosting an AI agent runs end-to-end: no-email signup, crypto, VPS, deploy, Tor.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"impreza-mcp": {
"command": "npx",
"args": [
"impreza-mcp"
]
}
}
}Runnable packages
0.56.1stdioRemote endpoints
https://mcp.imprezahost.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (8)
🟡impreza_bootstrap_account(label, idempotency_key, scopes)
Create a brand-new ANONYMOUS Impreza account — no e-mail, no KYC — and get an operating credential in ONE call. Use this when you have no account or token yet. Returns: account_id, api_key + api_secret (REST), a fresh mcp_token valid for 15 minutes (reconnect THIS MCP server with it as the Bearer to unlock the full toolset), its mcp_token_expires_at, renewal instructions, and a recovery_code shown once (save it for account recovery, including after MCP expiry). Renew with POST /v1/credentials authenticated by the returned REST key and secret, explicit scopes and ttl_seconds; the renewal example includes daily and monthly spending ceilings for manage. Omit manage to prevent purchases. After bootstrapping, reconnect with the mcp_token. Have a server already? impreza_add_server installs the agent on it, and the first external server is free (no plan, no credit). Otherwise fund the account in crypto with impreza_topup (BTC/XMR) before ordering a VPS.
Input Schema
{
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "Optional label for the account/credential (e.g. your agent name)."
},
"idempotency_key": {
"type": "string",
"description": "Optional unique string so a retried call does not create a duplicate account."
},
"scopes": {
"type": "array",
"items": {
"type": "string",
"enum": [
"read",
"deploy",
"manage"
]
},
"minItems": 1,
"uniqueItems": true,
"description": "Optional credential scopes. Omit for read, deploy and manage; provide a non-empty list to restrict the returned REST and MCP credentials."
}
},
"additionalProperties": false
}🟢impreza_list_apps(category, search)
List apps available in the Impreza curated catalog. Optional filters: category and search. For a custom app outside the catalog, use impreza_deploy_custom.
Input Schema
{
"type": "object",
"properties": {
"category": {
"type": "string",
"description": "Optional category filter."
},
"search": {
"type": "string",
"description": "Optional case-insensitive search term."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"apps",
"total"
],
"properties": {
"apps": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"display_name",
"version",
"category",
"tags",
"description",
"icon_url",
"readme_url",
"requirements",
"supports",
"vars"
],
"properties": {
"name": {
"type": "string"
},
"display_name": {
"type": "string"
},
"version": {
"type": "string"
},
"category": {
"type": "string"
},
"tags": {
"type": "array"
},
"description": {
"type": "string"
},
"icon_url": {
"type": "string"
},
"readme_url": {
"type": "string"
},
"requirements": {
"type": "object"
},
"supports": {
"type": "object"
},
"vars": {
"type": "array"
}
}
}
},
"total": {
"type": "integer"
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"next_steps"
],
"properties": {
"code": {
"type": "string",
"pattern": "^[A-Z][A-Z_0-9]{1,63}$"
},
"message": {
"type": "string"
},
"next_steps": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"action",
"doc"
],
"properties": {
"action": {
"type": "string"
},
"tool": {
"type": "string"
},
"missing": {
"type": "array",
"items": {
"type": "string"
}
},
"doc": {
"type": "string",
"pattern": "^https://docs[.]imprezahost[.]com/"
},
"requires": {
"type": "string"
}
}
}
}
}
}
}
}
]
}🟢impreza_search_docs(query, limit, section)
Search the Impreza documentation and get the actual paragraph back. Use this BEFORE guessing an argument, a field name or how a flow works — "container_name 502", "onion", "how does topup work", "manifest routing", "rate limit". Returns the matching sections with their heading trail and the relevant excerpt, so you answer from what the docs say instead of from a guess. A guessed argument costs a 400 and a round trip; this costs one call. Also use it when a customer asks how something works: the answer is written down and you can quote it.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Plain words or an exact term, e.g. \"container_name\", \"ready_for_deploy\", \"crypto payment\"."
},
"limit": {
"type": "number",
"description": "Maximum sections (1-10, default 3)."
},
"section": {
"type": "string",
"description": "Instead of searching, return one whole section by the heading a previous result gave you (e.g. \"Manifest-mode routing contract\"). Use when the excerpt was cut short."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"anyOf": [
{
"type": "object",
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"query",
"total",
"results",
"source",
"note"
],
"properties": {
"query": {
"type": "string"
},
"total": {
"type": "integer"
},
"source": {
"type": "string"
},
"note": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"title",
"trail",
"score",
"matched",
"excerpt"
],
"properties": {
"title": {
"type": "string"
},
"trail": {
"type": "string"
},
"score": {
"type": "integer"
},
"matched": {
"type": "array",
"items": {
"type": "string"
}
},
"excerpt": {
"type": "string"
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"title",
"trail",
"body",
"source"
],
"properties": {
"title": {
"type": "string"
},
"trail": {
"type": "string"
},
"body": {
"type": "string"
},
"source": {
"type": "string"
}
}
}
]
},
{
"type": "object",
"additionalProperties": false,
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"next_steps"
],
"properties": {
"code": {
"type": "string",
"pattern": "^[A-Z][A-Z_0-9]{1,63}$"
},
"message": {
"type": "string"
},
"next_steps": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"action",
"doc"
],
"properties": {
"action": {
"type": "string"
},
"tool": {
"type": "string"
},
"missing": {
"type": "array",
"items": {
"type": "string"
}
},
"doc": {
"type": "string",
"pattern": "^https://docs[.]imprezahost[.]com/"
},
"requires": {
"type": "string"
}
}
}
}
}
}
}
}
]
}🟢impreza_validate_manifest(manifest)
Check a custom-deploy manifest BEFORE deploying it. Returns `errors` — the exact reasons the deploy endpoint would reject it, checked by the same validator, so no errors means it will not be turned away for a known reason — and `warnings`: footguns that deploy fine and then hurt (unpinned image, no restart policy, a published port bypassing the reverse proxy) plus the PRIVACY findings that matter on this product: third-party CDN/font/analytics origins, public DNS resolvers, hardcoded timezones, literal secrets, outbound mail. Every finding carries a `fix`. Call this before impreza_deploy_custom: one call here beats a deploy that reports "running" and 502s. Never include credentials in source text: secret detection cannot inspect arbitrary source or configuration. Enter runtime secrets through the owner portal link.
Input Schema
{
"type": "object",
"properties": {
"manifest": {
"type": "object",
"description": "The full manifest object you would pass to impreza_deploy_custom, including runtime.compose_yaml and any network.reverse_proxy.routes."
}
},
"required": [
"manifest"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"valid",
"errors",
"warnings",
"checked"
],
"properties": {
"valid": {
"type": "boolean"
},
"errors": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"fix"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"fix": {
"type": "string"
}
}
}
},
"warnings": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"fix"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"fix": {
"type": "string"
}
}
}
},
"checked": {
"type": "object"
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"next_steps"
],
"properties": {
"code": {
"type": "string",
"pattern": "^[A-Z][A-Z_0-9]{1,63}$"
},
"message": {
"type": "string"
},
"next_steps": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"action",
"doc"
],
"properties": {
"action": {
"type": "string"
},
"tool": {
"type": "string"
},
"missing": {
"type": "array",
"items": {
"type": "string"
}
},
"doc": {
"type": "string",
"pattern": "^https://docs[.]imprezahost[.]com/"
},
"requires": {
"type": "string"
}
}
}
}
}
}
}
}
]
}🟢impreza_domain_check(domain)
Check domain availability + price before registering. Pass one domain or several comma-separated. Read-only.
Input Schema
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"description": "Domain(s) to check, e.g. \"example.com\" or \"a.com,b.net\"."
}
},
"required": [
"domain"
],
"additionalProperties": false
}🟢impreza_domain_pricing
List registration, renewal and transfer prices for the TLDs Impreza sells, in the account currency. Use this to compare prices and choose a TLD before impreza_domain_check or impreza_register_domain. Read-only.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢impreza_list_products(type, group)
List the products a customer can order (VPS, Tor hosting, dedicated servers, …) with pricing in the account currency. Filter to server products with type "server". The VPS is one configurable product (configurable: true, priced from its smallest size) — get its locations, operating systems and sizes with impreza_vps_offer. Fixed plans return id, name, group and per-cycle price + setup fee — feed the id + a billing_cycle into impreza_order_vps.
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Product type filter. Use \"server\" for VPS / dedicated plans."
},
"group": {
"type": "string",
"description": "Filter by product group name (substring), e.g. \"VPS\"."
}
},
"additionalProperties": false
}🟢impreza_vps_offer(billing_cycle, location, os, cpu_cores, memory_gb, ...)
What a new VPS can be, and what it costs. Lists the locations (with each jurisdiction's note), the operating systems, the CPU/memory/disk ranges with the price per unit for every billing cycle, and the apps it can be born with, in the account currency. Pass a whole configuration (billing_cycle, location, os, cpu_cores, memory_gb, disk_gb) to get its exact price instead — what is due today, what it renews at, whether the balance covers it and whether that location has room right now. With app omitted the quote means '@agent', this MCP's default, the same as impreza_order_vps. Then order it with impreza_order_vps using the same values. Read-only.
Input Schema
{
"type": "object",
"properties": {
"billing_cycle": {
"type": "string",
"description": "Optional, to price a configuration: monthly, quarterly, semiannually, annually, biennially or triennially."
},
"location": {
"type": [
"string",
"number"
],
"description": "Optional: a location id, slug or name from this tool, e.g. \"romania\"."
},
"os": {
"type": [
"string",
"number"
],
"description": "Optional: an operating system id, slug or name from this tool, e.g. \"ubuntu-24.04\"."
},
"cpu_cores": {
"type": "number",
"description": "Optional: vCPU count, inside the range this tool lists."
},
"memory_gb": {
"type": "number",
"description": "Optional: memory in GB, inside the range this tool lists."
},
"disk_gb": {
"type": "number",
"description": "Optional: SSD disk in GB, inside the range this tool lists."
},
"app": {
"type": "string",
"description": "Optional: what it is born with — '@agent' (this MCP's default when omitted: the Impreza agent, which installs on first boot, not instantly); 'none' for a bare OS; '@agent-mcp', a '@panel-*' choice or a catalog app name. The customer can request the agent later via impreza_install_agent with confirmation."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"anyOf": [
{
"type": "object",
"$comment": "Two answers: the offer (no or partial arguments) and the exact quote of one whole configuration.",
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"product_id",
"name",
"description",
"currency",
"billing_cycles",
"locations",
"operating_systems",
"resources",
"limits",
"apps",
"starting_at",
"pricing",
"order",
"balance"
],
"properties": {
"product_id": {
"type": "integer"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"currency": {
"type": "string"
},
"billing_cycles": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"cycle",
"months"
],
"properties": {
"cycle": {
"type": "string",
"enum": [
"monthly",
"quarterly",
"semiannually",
"annually",
"biennially",
"triennially"
]
},
"months": {
"type": "integer"
}
}
}
},
"locations": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"slug",
"name"
],
"properties": {
"id": {
"type": "integer"
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"country": {
"type": "string"
},
"badge": {
"type": "string"
},
"best_for": {
"type": "string"
},
"surcharge": {
"type": "object",
"additionalProperties": {
"type": "string",
"pattern": "^-?[0-9]+.[0-9]{2}$"
}
}
}
}
},
"operating_systems": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"slug",
"name",
"family"
],
"properties": {
"id": {
"type": "integer"
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"family": {
"type": "string"
},
"surcharge": {
"type": "object",
"additionalProperties": {
"type": "string",
"pattern": "^-?[0-9]+.[0-9]{2}$"
}
}
}
}
},
"resources": {
"type": "object"
},
"limits": {
"type": "object",
"properties": {
"memory_gb_per_core": {
"type": [
"string",
"null"
]
},
"disk_gb_per_core": {
"type": [
"string",
"null"
]
}
}
},
"apps": {
"type": "object",
"properties": {
"default": {
"type": "string"
},
"options": {
"type": "array",
"items": {
"type": "string"
}
},
"note": {
"type": "string"
}
}
},
"starting_at": {
"type": "object",
"additionalProperties": {
"type": "string",
"pattern": "^-?[0-9]+.[0-9]{2}$"
}
},
"pricing": {
"type": "string"
},
"order": {
"type": "string"
},
"balance": {
"type": "string",
"pattern": "^-?[0-9]+.[0-9]{2}$"
},
"_note": {
"type": "string",
"$comment": "Hosted only: added when some but not all of the quote arguments were passed."
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"product_id",
"product",
"currency",
"billing_cycle",
"months",
"lines",
"recurring",
"setup_fee",
"due_today",
"due_today_cents",
"renews",
"balance",
"balance_covers",
"top_up_needed",
"exact",
"location_available",
"order"
],
"properties": {
"product_id": {
"type": "integer"
},
"product": {
"type": "string"
},
"currency": {
"type": "string"
},
"billing_cycle": {
"type": "string"
},
"months": {
"type": "integer"
},
"configuration": {
"type": "object"
},
"lines": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"item",
"quantity",
"unit_price",
"amount"
],
"properties": {
"item": {
"type": "string"
},
"quantity": {
"type": "integer"
},
"unit_price": {
"type": "string",
"pattern": "^-?[0-9]+.[0-9]{2}$"
},
"amount": {
"type": "string",
"pattern": "^-?[0-9]+.[0-9]{2}$"
},
"setup_fee": {
"type": "string",
"pattern": "^-?[0-9]+.[0-9]{2}$"
}
}
}
},
"recurring": {
"type": "string",
"pattern": "^-?[0-9]+.[0-9]{2}$"
},
"setup_fee": {
"type": "string",
"pattern": "^-?[0-9]+.[0-9]{2}$"
},
"due_today": {
"type": "string",
"pattern": "^-?[0-9]+.[0-9]{2}$"
},
"due_today_cents": {
"type": "integer"
},
"renews": {
"type": "string"
},
"balance": {
"type": "string",
"pattern": "^-?[0-9]+.[0-9]{2}$"
},
"balance_covers": {
"type": "boolean"
},
"top_up_needed": {
"anyOf": [
{
"type": "string",
"pattern": "^-?[0-9]+.[0-9]{2}$"
},
{
"type": "null"
}
]
},
"exact": {
"type": "boolean"
},
"note": {
"type": "string"
},
"location_available": {
"type": [
"boolean",
"null"
],
"$comment": "null when the provisioning module cannot tell (not installed, or it failed to answer)."
},
"order": {
"type": "object",
"properties": {
"method": {
"type": "string"
},
"path": {
"type": "string"
},
"body": {
"type": "object"
}
}
}
}
}
]
},
{
"type": "object",
"additionalProperties": false,
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"next_steps"
],
"properties": {
"code": {
"type": "string",
"pattern": "^[A-Z][A-Z_0-9]{1,63}$"
},
"message": {
"type": "string"
},
"next_steps": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"action",
"doc"
],
"properties": {
"action": {
"type": "string"
},
"tool": {
"type": "string"
},
"missing": {
"type": "array",
"items": {
"type": "string"
}
},
"doc": {
"type": "string",
"pattern": "^https://docs[.]imprezahost[.]com/"
},
"requires": {
"type": "string"
}
}
}
}
}
}
}
}
]
}Community
Evidence