La mascotte orso polare di NordBastion seduta a una postazione di controllo missione tattica con monitor terminali olografici fluttuanti che mostrano codice ciano, una tastiera meccanica con tasti retroilluminati ciano e lo scudo-N ciano appoggiato accanto a lui, all'interno di una sala console nordica in pietra a vista con una finestra illuminata dall'aurora
API.v1 · REST · MCP · API

Esegua NordBastion dal codice.
KYC-free, pagato in crypto, completamente scriptabile.

Registrati, crea una chiave e prova l’accesso. Non serve alcun deposito.

Avvio rapido Tutti gli endpoint
Avvio rapido

Crea la tua chiave API prima di pagare.

Registrati, crea una chiave e prova l’accesso. Non serve alcun deposito.

cURL

Usa il token di accesso ottenuto con la registrazione o il login per creare una chiave API con permessi limitati. La chiave viene restituita in chiaro una sola volta.

# 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

Crea la tua chiave API prima di pagare.

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())

L’accesso tramite chiave API è indipendente dai pagamenti. Massimo 10 chiavi attive per account; revoca quelle inutilizzate.

Compatibilità e versioni

L’endpoint MCP ospitato viene aggiornato qui. I download stdio per versione includono codice sorgente e checksum SHA-256.

MCP ospitato

https://nordbastion.com/mcp
Versione
1.1.0
Versioni del protocollo
2026-07-28 · 2025-11-25 · 2025-06-18 · 2025-03-26
Ultima verifica
2026-09-15

Invia le credenziali nell’intestazione Authorization o nell’argomento access_token se il client MCP non consente di impostare intestazioni.

L’autorizzazione OAuth nel browser non è disponibile. Usa un token Bearer o l’argomento esplicito 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"
}}

Genera le chiavi SSH localmente. Carica solo la chiave pubblica; conserva la privata sul tuo dispositivo.

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

Scarica MCP 0.2.0

Python ≥ 3.10 · MCP SDK 2.2.0 · MIT

Wheel · Codice sorgente · SHA-256 · Changelog

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

Riferimento endpoint

OpenAPI 3.1 · llms-agents.txt

Gli SDK Python, TypeScript, Go e Rust e la CLI sono previsti. Usa REST o MCP oggi.

MethodEndpointAmbitoStato
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

Pagamento

Esplora e prova prima di aggiungere fondi. Le ricariche in criptovaluta servono solo per i servizi a pagamento.

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

x402 supporta pagamenti USDC firmati su Base tramite l’endpoint delle ricariche. Attendi la conferma del saldo prima di ordinare.

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

Limiti di frequenza

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

L’attività dell’account viene registrata nel log di audit dell’API. Credenziali e corpi delle richieste sono esclusi.

Ottenere API key

Hosting privato, costruito nel Nord.