Skip to main content
Developers

Build on it. Or let an AI agent run it.

A clean REST API for your own integrations, and a native Model Context Protocol server so an AI agent can manage a hosting account end to end — without anyone opening the client area.

API Reference MCP for AI Agents

REST API

Token-authenticated JSON over HTTPS. Create a token under Client Area ▸ Security ▸ API Tokens.

curl -H "Authorization: Bearer <token>" \
  https://host.mrbismarck.co.ke/api/v1/invoices
  • GET /api/v1/whoami Who the token belongs to
  • GET /api/v1/invoices List invoices
  • GET /api/v1/invoices/{id} One invoice with line items
  • GET /api/v1/services Hosting services
  • GET /api/v1/domains Domains & expiry dates
  • GET /api/v1/tickets Support tickets
  • POST /api/v1/tickets Open a ticket
Full OpenAPI reference →

MCP — for AI agents

MCP endpoint URL
https://host.mrbismarck.co.ke/mcp
Transport
streamable HTTP
Protocol
JSON-RPC 2.0
Method
POST
Auth
Bearer token
Discovery (no auth)
https://host.mrbismarck.co.ke/mcp/discover

Point any MCP-capable agent at our endpoint and it can check invoices, pay from credit, manage domains and raise tickets on your behalf. Everything is scoped to the token's own account.

{
  "mcpServers": {
    "imara-hosting": {
      "url": "https://host.mrbismarck.co.ke/mcp",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Available tools

get_account
Get the authenticated account profile: name, email, company, country, currency, account credit balance and status.
list_services
List hosting services on the account with product, domain, status, billing cycle, amount and next due date.
get_service_usage
Get live disk, bandwidth and account usage for one hosting service from its server.
list_domains
List domains on the account with registrar, expiry date, days until expiry and auto-renew status.
check_domain
Check whether a domain name is available to register, with pricing when available.
list_invoices
List invoices on the account with number, status, total, balance due and due date.
get_invoice
Get one invoice in full, including its line items, payments applied and balance due.
pay_invoice_with_credit
Pay an unpaid invoice using the account credit balance. Fails safely if credit is insufficient. Does not charge a card.
list_tickets
List support tickets on the account with number, department, subject, status and last reply time.
get_ticket
Read one support ticket including the full reply thread.
open_ticket
Open a new support ticket. The department determines the ticket number prefix (Billing→BILS, Support→SURP, General Inquiries→TKT, Admin→ADMN).
reply_ticket
Post a reply to an existing support ticket on the account.
account_summary
One-call overview an agent can lead with: counts of active services, domains expiring within 30 days, unpaid invoices with total owed, and open tickets.

Destructive operations are deliberately excluded — an agent can pay, open tickets and order, but cannot terminate services or delete data.