사이언 코드를 표시하는 부유 홀로그램 터미널 모니터, 사이언으로 빛나는 키캡의 기계식 키보드, 옆에 기대어 있는 사이언 N-shield가 있는 전술 미션 컨트롤 워크스테이션에 앉아 있는 NordBastion 북극곰 마스코트, 오로라가 비치는 창문이 있는 노출된 Nordic 석재 콘솔실 내부
API.v1 · REST · MCP · API

코드에서 NordBastion을 운영하세요.
KYC 없음, 암호화폐 결제, 완전한 스크립팅 지원.

가입하고 키를 만든 다음 접근을 테스트하세요. 입금은 필요하지 않습니다.

빠른 시작 모든 엔드포인트
빠른 시작

결제 전에 API 키를 만드세요.

가입하고 키를 만든 다음 접근을 테스트하세요. 입금은 필요하지 않습니다.

cURL

가입 또는 로그인 시 받은 액세스 토큰으로 권한을 제한한 API 키를 만드세요. 키는 평문으로 한 번만 반환됩니다.

# 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

결제 전에 API 키를 만드세요.

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 키 접근은 결제와 무관합니다. 계정당 활성 키는 최대 10개이며, 사용하지 않는 키는 폐기하세요.

호환성과 릴리스

호스팅된 MCP 엔드포인트는 여기에서 업데이트됩니다. 버전별 stdio 다운로드에는 소스 코드와 SHA-256 체크섬이 포함됩니다.

호스팅된 MCP

https://nordbastion.com/mcp
버전
1.1.0
프로토콜 버전
2026-07-28 · 2025-11-25 · 2025-06-18 · 2025-03-26
마지막 검증
2026-09-15

Authorization 헤더로 인증 정보를 보내세요. MCP 클라이언트에서 헤더를 설정할 수 없으면 access_token 인수를 사용하세요.

브라우저 OAuth 인증은 제공되지 않습니다. Bearer 토큰이나 명시적인 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"
}}

SSH 키는 로컬에서 생성하세요. 공개 키만 업로드하고 개인 키는 기기에 보관하세요.

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

MCP 0.2.0 다운로드

Python ≥ 3.10 · MCP SDK 2.2.0 · MIT

Wheel · 소스 코드 · SHA-256 · Changelog

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

엔드포인트 참조

OpenAPI 3.1 · llms-agents.txt

Python, TypeScript, Go, Rust SDK와 CLI는 계획 중입니다. 현재는 REST 또는 MCP를 사용하세요.

Method엔드포인트범위상태
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

결제

충전 전에 살펴보고 테스트하세요. 암호화폐 충전은 유료 서비스에만 필요합니다.

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

x402는 충전 엔드포인트를 통해 Base의 서명된 USDC 결제를 지원합니다. 주문 전에 잔액 반영이 확인될 때까지 기다리세요.

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

속도 제한

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

계정 활동은 API 감사 로그에 기록됩니다. 인증 정보와 요청 본문은 포함되지 않습니다.

API 키 가져오기

북유럽에서 구축한 프라이빗 호스팅.