Das NordBastion-Polarbär-Maskottchen sitzt an einem taktischen Mission-Control-Arbeitsplatz mit schwebenden holographischen Terminal-Monitoren, die cyan-Code zeigen, einer mechanischen Tastatur mit cyan-beleuchteten Keycaps und dem cyan-N-Schild, der daneben lehnt, in einem freiliegenden nordischen Steinkonsolen-Raum mit einem aurora-beleuchteten Fenster
API.v1 · REST · MCP · API

NordBastion per Code betreiben.
KYC-frei, krypto-bezahlt, vollständig skriptierbar.

Registrieren Sie sich, erstellen Sie einen Schlüssel und testen Sie den Zugriff. Keine Einzahlung erforderlich.

Schnellstart Alle Endpunkte
Schnellstart

Erstellen Sie Ihren API-Schlüssel vor der Zahlung.

Registrieren Sie sich, erstellen Sie einen Schlüssel und testen Sie den Zugriff. Keine Einzahlung erforderlich.

cURL

Verwenden Sie das Zugriffstoken aus Registrierung oder Anmeldung, um einen API-Schlüssel mit begrenzten Rechten zu erstellen. Der Schlüssel wird nur einmal im Klartext ausgegeben.

# bash + curl + jq
# Set NB_EMAIL and NB_PASSWORD in your environment.
set -eu
: "${NB_EMAIL:?Set NB_EMAIL}" "${NB_PASSWORD:?Set NB_PASSWORD}"
API=https://nordbastion.com/v1
TOKEN=$(jq -n '{email:env.NB_EMAIL,password:env.NB_PASSWORD}' |
  curl --fail-with-body -sS "$API/auth/register" \
    -H 'Content-Type: application/json' --data-binary @- |
  jq -er '.tokens.access_token')
KEY=$(curl --fail-with-body -sS "$API/auth/api-keys" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"name":"agent-read","scope":"read"}' |
  jq -er '.plaintext')
curl --fail-with-body -sS "$API/account/balance" \
  -H "Authorization: Bearer $KEY"
# Store KEY in your secret store. Do not print it.
unset TOKEN KEY

Python

Erstellen Sie Ihren API-Schlüssel vor der Zahlung.

import os
import requests

api = "https://nordbastion.com/v1"
with requests.Session() as client:
    signup = client.post(api + "/auth/register", json={
        "email": os.environ["NB_EMAIL"],
        "password": os.environ["NB_PASSWORD"],
    }, timeout=30)
    signup.raise_for_status()
    token = signup.json()["tokens"]["access_token"]
    created = client.post(api + "/auth/api-keys",
        headers={"Authorization": f"Bearer {token}"},
        json={"name": "agent-read", "scope": "read"},
        timeout=30)
    created.raise_for_status()
    key = created.json()["plaintext"]
    # Store key in your secret store; never log it.
    balance = client.get(api + "/account/balance",
        headers={"Authorization": f"Bearer {key}"},
        timeout=30)
    balance.raise_for_status()
    print(balance.json())

API-Schlüssel sind unabhängig von Zahlungen verfügbar. Höchstens 10 aktive Schlüssel pro Konto; widerrufen Sie ungenutzte Schlüssel.

Kompatibilität und Versionen

Der gehostete MCP-Endpunkt wird hier aktualisiert. Versionierte stdio-Downloads enthalten Quellcode und SHA-256-Prüfsummen.

Gehostetes MCP

https://nordbastion.com/mcp
Version
1.1.0
Protokollversionen
2026-07-28 · 2025-11-25 · 2025-06-18 · 2025-03-26
Zuletzt geprüft
2026-09-15

Senden Sie Zugangsdaten im Authorization-Header oder im Argument access_token, wenn Ihr MCP-Client keine Header setzen kann.

OAuth-Autorisierung im Browser ist nicht verfügbar. Verwenden Sie ein Bearer-Token oder das explizite Argument access_token.

Server metadata · MCP specification

MCP · register_account → create_api_key

{"name":"register_account","arguments":{
  "email":"agent@example.com",
  "password":"YOUR_STRONG_PASSWORD"
}}

{"name":"create_api_key","arguments":{
  "name":"agent-read",
  "scope":"read",
  "access_token":"ACCESS_TOKEN_FROM_SIGNUP"
}}

{"name":"get_balance","arguments":{
  "access_token":"PLAINTEXT_FROM_CREATE_API_KEY"
}}

Erzeugen Sie SSH-Schlüssel lokal. Laden Sie nur den öffentlichen Schlüssel hoch; der private Schlüssel bleibt auf Ihrem Gerät.

ssh-keygen -t ed25519 -f ~/.ssh/nordbastion_agent
# add_ssh_key: public_key = contents of the .pub file

MCP 0.2.0 herunterladen

Python ≥ 3.10 · MCP SDK 2.2.0 · MIT

Wheel · Quellcode · SHA-256 · Changelog

pip install https://nordbastion.com/downloads/nordbastion_mcp-0.2.0-py3-none-any.whl
nordbastion-mcp

Endpunktreferenz

OpenAPI 3.1 · llms-agents.txt

SDKs für Python, TypeScript, Go und Rust sowie die CLI sind geplant. Nutzen Sie heute REST oder MCP.

MethodEndpunktBereichStatus
POST/v1/auth/registerpublicLIVE
POST/v1/auth/loginpublicLIVE
POST/v1/auth/login/totppublicLIVE
POST/v1/auth/token/refreshpublicLIVE
POST/v1/auth/recoverpublicPLANNED
GET/v1/auth/sessionsfullLIVE
DELETE/v1/auth/sessions/{token_id}fullLIVE
POST/v1/auth/totp/setupfullLIVE
POST/v1/auth/totp/enablefullLIVE
POST/v1/auth/totp/disablefullLIVE
POST/v1/auth/passwordfullLIVE
POST/v1/auth/api-keysfullLIVE
GET/v1/auth/api-keysreadLIVE
DELETE/v1/auth/api-keys/{key_id}fullLIVE
GET/v1/accountreadLIVE
PATCH/v1/accountfullPLANNED
GET/v1/account/balancereadLIVE
GET/v1/account/usagereadLIVE
GET/v1/account/audit-logreadLIVE
GET/v1/billing/coinspublicLIVE
POST/v1/billing/topupsbillingLIVE
GET/v1/billing/topupsreadLIVE
GET/v1/billing/topups/{order_number}readLIVE
POST/v1/billing/topups/{order_number}/cancelbillingLIVE
GET/v1/billing/bonus-tierspublicLIVE
GET/v1/catalogpublicLIVE
GET/v1/catalog/vpspublicLIVE
GET/v1/catalog/dedicatedpublicLIVE
GET/v1/catalog/bastionspublicLIVE
GET/v1/catalog/imagespublicLIVE
GET/v1/catalog/{code}publicLIVE
POST/v1/serversserversLIVE
GET/v1/serversreadLIVE
GET/v1/servers/{order_number}readLIVE
PATCH/v1/servers/{order_number}serversLIVE
DELETE/v1/servers/{order_number}serversLIVE
POST/v1/ssh-keysserversLIVE
GET/v1/ssh-keysreadLIVE
GET/v1/ssh-keys/{id}readLIVE
DELETE/v1/ssh-keys/{id}serversLIVE
POST/v1/webhooksfullLIVE
GET/v1/webhooksreadLIVE
DELETE/v1/webhooks/{id}fullLIVE
POST/v1/webhooks/{id}/testfullLIVE
GET/v1/transparency/canarypublicLIVE
GET/v1/transparency/peeringpublicLIVE
GET/v1/transparency/statuspublicLIVE
GET/v1/agents/directorypublicLIVE
POST/v1/agents/directoryfullLIVE
POST/v1/oauth/registerpublicLIVE
POST/v1/oauth/tokenpublicLIVE
POST/v1/oauth/revokepublicLIVE
GET/v1/oauth/introspectpublicLIVE

Zahlung

Prüfen und testen Sie vor einer Einzahlung. Krypto-Aufladungen sind nur für kostenpflichtige Dienste nötig.

POST /v1/billing/topups · {"amount_usd":50,"crypto":"XMR"} · USD 30–10,000

x402 unterstützt signierte USDC-Zahlungen auf Base über den Auflade-Endpunkt. Warten Sie vor der Bestellung auf die bestätigte Gutschrift.

x402: POST /v1/billing/topups · X-Payment-Mode: x402 · {"amount_usd":50}

Ratenlimits

API key: 120 / min · 3,000 / hour · public: 30 / min · HTTP 429 + Retry-After

Kontoaktivitäten werden im API-Auditprotokoll erfasst. Zugangsdaten und Anfrageinhalte werden nicht aufgenommen.

API-Schlüssel holen

Privates Hosting, im Norden gebaut.