mcp-all-inkl

MCP Server for managing All-Inkl.com web hosting via the KAS SOAP API. Gives Claude and other MCP-compatible AI assistants direct access to domains, DNS, email, databases, cronjobs, SSL, and more.

9 tools, 53 actions - full coverage of the KAS API, with all SOAP/XML complexity abstracted into clean JSON responses.

Features

• Complete KAS API coverage across 9 tool categories
• Plain-text authentication over HTTPS (secure via TLS)
• Automatic session token management with re-auth on expiry
• Flood protection awareness - respects KAS API rate limits
• Stack-based SOAP/XML parser that correctly handles deeply nested <item> structures
• Auto-fix for common parameter issues (e.g. missing trailing dot on DNS zone_host)
• pick and filter params on all tools to reduce response size and token usage

Requirements

• Node.js 22+
• All-Inkl.com KAS account with API access
• KAS login (format: w0XXXXXXX) and password

Setup

Claude Desktop / Claude.ai

Add to claude_desktop_config.json:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "all-inkl": {
      "command": "npx",
      "args": ["-y", "mcp-all-inkl"],
      "env": {
        "KAS_LOGIN": "w0XXXXXXX",
        "KAS_PASSWORD": "your-kas-password"
      }
    }
  }
}

Restart Claude Desktop after saving.

Claude Code

claude mcp add all-inkl \
  -e KAS_LOGIN=w0XXXXXXX \
  -e KAS_PASSWORD=your-kas-password \
  -- npx -y mcp-all-inkl

Or add to .mcp.json in your project root:

{
  "mcpServers": {
    "all-inkl": {
      "command": "npx",
      "args": ["-y", "mcp-all-inkl"],
      "env": {
        "KAS_LOGIN": "w0XXXXXXX",
        "KAS_PASSWORD": "your-kas-password"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "all-inkl": {
      "command": "npx",
      "args": ["-y", "mcp-all-inkl"],
      "env": {
        "KAS_LOGIN": "w0XXXXXXX",
        "KAS_PASSWORD": "your-kas-password"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

Same JSON format as above.

VS Code + GitHub Copilot

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "all-inkl": {
      "command": "npx",
      "args": ["-y", "mcp-all-inkl"],
      "env": {
        "KAS_LOGIN": "w0XXXXXXX",
        "KAS_PASSWORD": "your-kas-password"
      }
    }
  }
}

Cline

Open Cline -> MCP Servers icon -> Edit MCP Settings, then add the same JSON as Claude Desktop.

Continue.dev

Create .continue/mcpServers/all-inkl.json with the same JSON format.

OpenAI Codex CLI

codex mcp add all-inkl \
  --env KAS_LOGIN=w0XXXXXXX \
  --env KAS_PASSWORD=your-kas-password \
  -- npx -y mcp-all-inkl

Zed

Add to Zed settings.json (via Agent Panel -> Settings):

{
  "context_servers": {
    "all-inkl": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-all-inkl"],
        "env": {
          "KAS_LOGIN": "w0XXXXXXX",
          "KAS_PASSWORD": "your-kas-password"
        }
      }
    }
  }
}

Compatibility Matrix

Tool	Config Location
Claude Desktop / Claude.ai	claude_desktop_config.json
Claude Code	.mcp.json
Cursor	.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code + Copilot	.vscode/mcp.json
Cline	MCP Settings JSON
Continue.dev	.continue/mcpServers/*.json
Zed	settings.json
Codex CLI	.codex/config.toml
Roo Code	MCP Settings JSON
Google Antigravity	~/.gemini/settings.json

Environment Variables

Variable	Required	Default	Description
KAS_LOGIN	Yes	-	KAS account login (format: w0XXXXXXX)
KAS_PASSWORD	Yes	-	KAS account password

Get your KAS login from the KAS admin panel - it's shown in the top right after login.

pick & filter - Response Optimization

All tools support optional pick and filter parameters to reduce token usage on large responses.

pick - Return only specific fields

// Without pick: full DNS records with 8 fields each (~2,000 tokens for 18 records)
{ "action": "list", "params": { "zone_host": "example.com." } }

// With pick: only type and data (~400 tokens)
{ "action": "list", "params": { "zone_host": "example.com." }, "pick": ["record_type", "record_data"] }

filter - Filter array results by field values

// Only MX records
{ "action": "list", "params": { "zone_host": "example.com." }, "filter": { "record_type": "MX" } }

// Only a specific database
{ "action": "list", "filter": { "database_name": "d03f4990" } }

Combined - filter + pick

// MX records with only server and priority
{ "action": "list", "params": { "zone_host": "example.com." }, "filter": { "record_type": "MX" }, "pick": ["record_data", "record_aux"] }
// Returns: [{"record_data": "aspmx.l.google.com.", "record_aux": 1}, ...]

When to use:

• DNS zones with many records - filter by record_type to get only A, MX, TXT, etc.
• Mail accounts - pick only mail_login and domain_part instead of full quota details
• Databases - filter by database_comment or pick only database_name and used_database_space
• Any list action returning more data than needed

Tools & Actions

kas_dns - DNS Records

Manage A, AAAA, CNAME, MX, TXT, SRV records.

Important: zone_host must end with a trailing dot: "example.com." not "example.com". The server auto-appends it if missing, but best practice is to include it.

Action	Required Params	Description
list	zone_host	List all DNS records of a zone
create	zone_host, record_type, record_name, record_data, record_aux	Create record. record_name="" for zone root. record_aux=0 for most types, MX priority for MX
update	record_id	Update record (get record_id from list)
delete	record_id	Delete a record
reset	zone_host	Reset zone to defaults

kas_domain - Domains

Action	Required Params	Description
list	-	List all domains
list_tlds	-	List available TLDs
create	domain_name, domain_tld	Register a new domain
update	domain_name	Update domain settings (path, redirect, PHP version, etc.)
delete	domain_name	Delete a domain
move	domain_name, source_account, target_account	Move domain to another KAS account

kas_subdomain - Subdomains

Action	Required Params	Description
list	-	List all subdomains
create	subdomain_name, domain_name	Create subdomain (e.g. "www" + "example.com")
update	subdomain_name	Update subdomain settings
delete	subdomain_name	Delete a subdomain
move	subdomain_name, source_account, target_account	Move to another account

kas_database - MySQL Databases

Action	Required Params	Description
list	-	List all databases with size and comments
create	database_password	Create database (name auto-generated by KAS)
update	database_login	Update password, comment, or allowed hosts
delete	database_login	Delete a database

kas_mail - Email

Manages mailboxes, forwards, mailing lists, and filters.

Action	Required Params	Description
list	-	List all mailboxes
create	mail_password, local_part, domain_part	Create mailbox
update	mail_login	Update mailbox settings
delete	mail_login	Delete mailbox
list_forwards	-	List email forwards
create_forward	local_part, domain_part	Create forward
update_forward	mail_forward	Update forward targets
delete_forward	mail_forward	Delete forward
list_lists	-	List mailing lists
create_list	mailinglist_name, mailinglist_domain, mailinglist_password	Create mailing list
update_list	mailinglist_name	Update mailing list
delete_list	mailinglist_name	Delete mailing list
list_filters	-	List mail filters
add_filter	mail_login, filter	Add mail filter
delete_filter	mail_login	Delete mail filter

kas_cronjob - Cronjobs

Action	Required Params	Description
list	-	List all cronjobs
create	protocol, http_url, cronjob_comment, minute, hour, day_of_month, month, day_of_week	Create cronjob. Time values use crontab syntax (* for every)
update	cronjob_id	Update cronjob settings
delete	cronjob_id	Delete a cronjob

kas_ssl - SSL Certificates

Action	Required Params	Description
update	hostname, ssl_certificate_sni_key, ssl_certificate_sni_crt	Install/update SSL certificate

kas_account - Account Management

Action	Required Params	Description
list	-	List all accounts
get_resources	-	Resource limits and current usage
get_settings	-	Account settings
get_server_info	-	Server info (PHP versions, MySQL, OS)
create	account_kas_password, account_ftp_password	Create sub-account
update	account_login, account_kas_password	Update account
update_settings	-	Update account settings
update_superuser	account_login	Update superuser settings
delete	account_login	Delete an account

kas_system - System

Action	Required Params	Description
create_session	-	Create new auth session
get_space	-	Disk space overview
get_space_usage	directory	Detailed space usage for a directory
get_traffic	-	Traffic statistics

Example Responses

DNS Records

[
  {
    "record_zone": "example.com",
    "record_name": null,
    "record_type": "A",
    "record_data": "85.13.151.85",
    "record_aux": 0,
    "record_id": 56652527,
    "record_changeable": "Y",
    "record_deleteable": "Y"
  }
]

Databases

[
  {
    "database_name": "d03f4990",
    "database_login": "d03f4990",
    "database_password": null,
    "database_comment": "My App Database",
    "database_allowed_hosts": "localhost",
    "used_database_space": 44075.3
  }
]

Server Info

[
  { "service": "mysql", "version": "10.11.14", "version_type": "server" },
  { "service": "php", "interface": "cgi-fcgi", "file_extension": "php84", "version": 8.4 },
  { "service": "os", "distribution": "ubuntu", "version": 24 }
]

Architecture

Authentication Flow

1. SOAP POST to https://kasapi.kasserver.com/soap/KasAuth.php with kas_auth_type: "plain"
2. Receives session token (valid 60 minutes, auto-refreshes)
3. All subsequent API calls use kas_auth_type: "session" with the token
4. On session expiry or invalidation, automatic re-authentication

SOAP XML Parser

The KAS API returns deeply nested SOAP/XML with <item> tags at multiple levels. Standard regex-based parsing fails because greedy matching can't distinguish between nested <item> open/close pairs.

This server uses a stack-based parser that:

• Tracks <item> tag depth with a counter
• Only captures top-level items when depth returns to 0
• Recursively parses ns2:Map objects and SOAP-ENC:Array arrays
• Handles xsi:nil, xsd:int, xsd:float, and xsd:string types
• Returns clean JavaScript objects/arrays

API Parameter Format

The KAS API expects parameters as JSON inside a SOAP envelope. One critical detail: the parameter key for request params must be KasRequestParams (CamelCase), not kas_request_params (snake_case). Actions without parameters work with either format, which can mask this bug during development.

Flood Protection

KAS returns a KasFloodDelay value with each response. The server tracks this per action and automatically waits before sending the next request to the same endpoint.

pick & filter

All tools accept optional pick (array of field names) and filter (object with key-value pairs) parameters. These are applied client-side after the API response is parsed - filter removes non-matching entries from arrays, pick strips all fields except the specified ones. Both combine to dramatically reduce token usage: a full DNS zone with 18 records and 8 fields each (~2,000 tokens) can be reduced to just 5 MX records with 2 fields (~100 tokens).

Verify

Start a new conversation and ask:

List all my domains

The AI should call kas_domain with action list and return your domain list as JSON.

Other test queries:

• "Show me DNS records for example.com" - tests DNS with trailing dot auto-fix
• "How much disk space is left?" - tests system tools
• "What PHP versions are available?" - tests server info

Development

git clone https://github.com/hl9020/mcp-all-inkl.git
cd mcp-all-inkl
npm install
npm run build

Testing locally

Create a test file (excluded from git):

// test.mjs
process.env.KAS_LOGIN = "w0XXXXXXX";
process.env.KAS_PASSWORD = "your-password";
const { kasCall } = await import("./dist/kas-client.js");

const result = await kasCall("get_domains");
console.log(result.content[0].text);

node test.mjs

Project Structure

src/
  index.ts          # MCP server setup, tool definitions with descriptions
  kas-client.ts     # SOAP client, auth, XML parser, API caller
  types.ts          # TypeScript interfaces
  tools/
    dns.ts          # DNS records (5 actions)
    domain.ts       # Domains (6 actions)
    subdomain.ts    # Subdomains (5 actions)
    database.ts     # MySQL databases (4 actions)
    mail.ts         # Email, forwards, lists, filters (15 actions)
    cronjob.ts      # Cronjobs (4 actions)
    ssl.ts          # SSL certificates (1 action)
    account.ts      # Account management (9 actions)
    system.ts       # System info (4 actions)

Known Limitations

• KAS flood protection can cause temporary delays when making rapid successive calls
• SSL tool only supports update (installing certificates), not listing or deleting
• The KAS API itself has no pagination - large result sets are returned in full

Links

• All-Inkl.com KAS API Documentation
• KAS API SOAP Examples
• All-Inkl.com

License

MIT