O mascote urso-polar do NordBastion sentado em uma estação de trabalho de controle de missão tática com monitores de terminal holográficos flutuantes mostrando código ciano, um teclado mecânico com teclas iluminadas em ciano e o escudo-N ciano apoiado ao lado dele, dentro de uma sala de console de pedra Nórdica exposta com uma janela iluminada por aurora
API.v1 · REST · MCP · API

Execute o NordBastion pelo código.
KYC-free, pago em cripto, totalmente scriptável.

Cadastre-se, crie uma chave e teste o acesso. Nenhum depósito é necessário.

Início rápido Todos os endpoints
Início rápido

Crie sua chave API antes de pagar.

Cadastre-se, crie uma chave e teste o acesso. Nenhum depósito é necessário.

cURL

Use o token de acesso do cadastro ou login para criar uma chave API com permissões limitadas. A chave é retornada em texto simples uma única 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

Crie sua chave 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())

O acesso por chave API independe dos pagamentos. Máximo de 10 chaves ativas por conta; revogue as que não usa.

Compatibilidade e versões

O endpoint MCP hospedado é atualizado aqui. Os downloads stdio por versão incluem código-fonte e somas SHA-256.

MCP hospedado

https://nordbastion.com/mcp
Versão
1.1.0
Versões do protocolo
2026-07-28 · 2025-11-25 · 2025-06-18 · 2025-03-26
Última verificação
2026-09-15

Envie as credenciais no cabeçalho Authorization ou no argumento access_token se o cliente MCP não permitir definir cabeçalhos.

A autorização OAuth no navegador não está disponível. Use um token Bearer ou o 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"
}}

Gere as chaves SSH localmente. Envie apenas a chave pública; mantenha a privada no seu dispositivo.

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

Baixar MCP 0.2.0

Python ≥ 3.10 · MCP SDK 2.2.0 · MIT

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

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

Referência de endpoints

OpenAPI 3.1 · llms-agents.txt

Os SDKs de Python, TypeScript, Go e Rust e a CLI estão planejados. Use REST ou MCP hoje.

MethodPonto de acessoEscopoEstado
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

Explore e teste antes de adicionar fundos. Recargas em criptomoedas só são necessárias para serviços pagos.

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

x402 aceita pagamentos USDC assinados na Base pelo endpoint de recargas. Aguarde a confirmação do saldo antes de fazer o pedido.

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

Limites de taxa

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

A atividade da conta é registrada no log de auditoria da API. Credenciais e corpos das requisições não são incluídos.

Obter chave de API

Hospedagem privada, construída no Norte.