Quick Start

Authorization: Bearer moa_sk_xxxxxxxxxxxxxxxxxxxxx

npm install -g @moa-mcp/cli

# API 키 설정
moa config set api-key YOUR_API_KEY

# 설정 확인
moa config list

$ moa registry "서울특별시 강남구 테헤란로 123"

✓ 등기부등본 조회 완료

  주소      서울특별시 강남구 테헤란로 123
  소유자    홍길동
  유형      소유권
  등록일    2024-03-15

  포인트 사용: 5P (잔액: 1,495P)

{
  "mcpServers": {
    "moa": {
      "url": "https://api.moa-mcp.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "tools": [
    {
      "type": "mcp",
      "server_label": "moa",
      "server_url": "https://api.moa-mcp.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  ]
}

npm install @moa-mcp/sdk

import { MoaClient } from "@moa-mcp/sdk";

const moa = new MoaClient({
  apiKey: process.env.MOA_API_KEY!,
});

// 등기부등본 조회
const registry = await moa.registry.getDocument({
  address: "서울특별시 강남구 테헤란로 123",
  includeHistory: true,
});

console.log(registry.data.owner);
// => "홍길동"

// 건축물대장 조회
const building = await moa.building.getLedger({
  address: "서울특별시 강남구 테헤란로 123",
});

console.log(building.data.mainUse);
// => "업무시설"

// 토지대장 조회
const land = await moa.land.getLedger({
  address: "서울특별시 강남구 테헤란로 123",
});

console.log(land.data.officialPrice);
// => "15,200,000원/㎡"

/** API 공통 응답 */
interface MoaResponse<T> {
  success: true;
  data: T;
  usage: { points_used: number; remaining: number };
}

/** 에러 응답 */
interface MoaErrorResponse {
  success: false;
  error: {
    code: string;   // e.g. "ADDRESS_NOT_FOUND"
    message: string;
    status: number;  // HTTP status code
  };
}

/** 등기부등본 */
interface RegistryDocument {
  address: string;
  owner: string;
  registryType: string;
  registeredAt: string;
  rights: {
    type: string;
    holder: string;
    amount: string;
  }[];
}

/** 건축물대장 */
interface BuildingLedger {
  address: string;
  buildingName: string;
  mainUse: string;
  structure: string;
  floors: { above: number; below: number };
  totalArea: string;
  approvalDate: string;
}

/** 토지대장 */
interface LandLedger {
  address: string;
  landCategory: string;
  area: string;
  officialPrice: string;
  owner: string;
  ownershipShare: string;
}

import { MoaClient, MoaError } from "@moa-mcp/sdk";

try {
  const result = await moa.registry.getDocument({
    address: "잘못된 주소",
  });
} catch (error) {
  if (error instanceof MoaError) {
    console.error(error.code);    // "ADDRESS_NOT_FOUND"
    console.error(error.message); // "주소를 찾을 수 없습니다"
    console.error(error.status);  // 404
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_POINTS",
    "message": "포인트가 부족합니다. 충전 후 다시 시도하세요.",
    "status": 402
  }
}