MCP Tools Reference

v1 · 26 tools

AxHub MCP 서버가 노출하는 전체 tool 목록입니다. 각 tool은 입력 스키마 · 출력 · 필요 scope · 위험도를 포함합니다.

Source OpenAPI

DeployStable · v1

list_deployments

최근 배포 히스토리를 상태·시각·커밋·전략까지 같이 보여줘요. 페이지당 최대 20개예요.

Required scope: write
Avg response: < 2s
Idempotent: 네 — 반복해도 같은 결과
Side effect: 없어요. 조회만 해요.

Input schema

app_id*

number

앱 ID

page

number

페이지 번호 (기본 1)

per_page

number

페이지당 개수 (기본 10, 최대 20)

Output

Response · 200 OK

{}

Example

Natural (Claude)

이번 주에 배포한 버전 전부 보여줘

MCP raw

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_deployments",
    "arguments": {}
  }
}

ax CLI

curl -s -X POST "$AX_MCP_URL" \
  -H "Authorization: Bearer $AX_TOKEN" \
  -H "Mcp-Session-Id: $AX_SESSION" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_deployments","arguments":{}}}'

Error codes

UNAUTHORIZED401토큰이 없거나 만료됐어요. 다시 로그인하고 시도해 주세요.

FORBIDDEN_SCOPE403이 작업에 필요한 scope 가 토큰에 없어요 (read/write/admin).

APP_KEY_FORBIDDEN403app-key 토큰으론 쓸 수 없는 tool 이에요. OAuth 토큰이 필요해요.

Related tools

deploy_app rollback_deploy