La mascota oso polar de NordBastion sentada en un puesto de trabajo de control de misión táctico con monitores de terminal holográficos flotantes que muestran código cian, un teclado mecánico con teclas iluminadas en cian y el escudo N cian apoyado a su lado, dentro de una sala de consola de piedra nórdica expuesta con una ventana iluminada por la aurora
API.v1 · REST · MCP · API

Gestione NordBastion desde código.
Sin KYC, pagado en criptomoneda, completamente scriptable.

Regístrate, crea una clave y prueba el acceso. No se requiere depósito.

Inicio rápido Todos los endpoints
Inicio rápido

Crea tu clave API antes de pagar.

Regístrate, crea una clave y prueba el acceso. No se requiere depósito.

cURL

Usa el token de acceso del registro o inicio de sesión para crear una clave API con permisos limitados. La clave se devuelve en texto claro una sola vez.

# 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 tu clave API antes de pagar.

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

El acceso mediante claves API es independiente de los pagos. Máximo 10 claves activas por cuenta; revoca las que no uses.

Compatibilidad y versiones

El punto de acceso MCP alojado se actualiza aquí. Las descargas stdio por versión incluyen código fuente y sumas SHA-256.

MCP alojado

https://nordbastion.com/mcp
Versión
1.1.0
Versiones del protocolo
2026-07-28 · 2025-11-25 · 2025-06-18 · 2025-03-26
Última verificación
2026-09-15

Envía las credenciales en la cabecera Authorization o en el argumento access_token si tu cliente MCP no permite configurar cabeceras.

La autorización OAuth en el navegador no está disponible. Usa un token Bearer o el argumento explícito 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 las claves SSH localmente. Sube solo la clave pública; conserva la privada en tu dispositivo.

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

Descargar MCP 0.2.0

Python ≥ 3.10 · MCP SDK 2.2.0 · MIT

Wheel · Código fuente · SHA-256 · Changelog

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

Referencia de endpoint

OpenAPI 3.1 · llms-agents.txt

Los SDK de Python, TypeScript, Go y Rust y la CLI están previstos. Usa REST o MCP hoy.

MethodExtremoÁmbitoEstado
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

Pago

Explora y prueba antes de añadir fondos. Las recargas en criptomonedas solo son necesarias para servicios de pago.

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

x402 admite pagos USDC firmados en Base mediante el punto de acceso de recargas. Espera a que se confirme el saldo antes de pedir.

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

Límites de velocidad

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

La actividad de la cuenta se registra en el historial de auditoría de la API. Se excluyen las credenciales y los cuerpos de las solicitudes.

Obtener clave API

Alojamiento privado, construido en el Norte.