> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 도구 카탈로그

> ChainStream MCP Server 전체 도구 레퍼런스

ChainStream MCP Server는 API Reference에 정의된 모든 인터페이스를 지원합니다. AI가 이러한 도구를 직접 호출하여 온체인 데이터를 가져올 수 있습니다.

<Note>
  MCP 도구의 파라미터와 반환값은 REST API와 동일합니다. 상세 필드 설명은 [API Reference](/ko/api-reference/authentication/authenticate)를 참조하세요.
</Note>

***

## 도구 개요

<Tabs>
  <Tab title="데이터 조회">
    | 도구 카테고리    | 기능                             |
    | ---------- | ------------------------------ |
    | Token      | 토큰 검색, 정보, 가격, 캔들, 홀더, 보안 검사   |
    | Wallet     | 잔액, PnL, 통계, 잔액 변동             |
    | Trade      | 거래 기록, 활동, 상위 트레이더             |
    | DexPool    | 풀 정보, 스냅샷                      |
    | Ranking    | 인기 토큰, 신규 토큰, 졸업 임박, 마이그레이션 완료 |
    | Blockchain | 체인 정보, 최신 블록                   |
  </Tab>

  <Tab title="트레이딩 실행">
    | 도구 카테고리     | 기능                       |
    | ----------- | ------------------------ |
    | Dex         | 견적, 경로, 스왑 실행            |
    | DeFi        | Pumpfun/Moonshot에서 토큰 생성 |
    | Transaction | 트랜잭션 전송, 가스 추정           |
    | RedPacket   | 홍바오 생성/수령                |
  </Tab>

  <Tab title="인프라">
    | 도구 카테고리    | 기능               |
    | ---------- | ---------------- |
    | Webhook    | 엔드포인트 관리, 이벤트 구독 |
    | Blockchain | 지원 체인, 최신 블록     |
  </Tab>

  <Tab title="실시간 구독">
    | 구독 유형            | 기능          |
    | ---------------- | ----------- |
    | Candles          | 실시간 가격 추이   |
    | Token Stats      | 실시간 거래 통계   |
    | New Tokens       | 신규 토큰 생성 알림 |
    | Wallet Balance   | 잔액 변동 알림    |
    | Trade Activities | 실시간 거래 스트림  |
    | Pool             | 풀 상태 변동     |
  </Tab>
</Tabs>

***

## Token 도구

### token\_search

토큰을 검색합니다.

```
PEPE 관련 토큰 검색해 줘
```

### token\_get

토큰 상세 정보를 조회합니다.

```
토큰 So11111111111111111111111111111111111111112의 상세 정보를 보여 줘
```

### token\_get\_metadata

토큰 메타데이터(이름, 심볼, 로고 등)를 조회합니다.

```
이 토큰의 로고와 소셜 미디어 링크를 가져와 줘
```

### token\_get\_stats

토큰 통계(거래량, 매수/매도 횟수 등)를 조회합니다.

```
이 토큰의 지난 24시간 거래 통계를 보여 줘
```

### token\_get\_price

현재 토큰 가격을 조회합니다.

```
BONK의 현재 가격은 얼마야?
```

### token\_get\_prices

토큰 가격 이력을 조회합니다.

```
지난 1주일간 ETH 가격 추이를 보여 줘
```

### token\_get\_candles

토큰 캔들스틱 데이터를 조회합니다.

```
SOL의 최근 1시간봉 100개를 가져와 줘
```

### token\_get\_holders

토큰 홀더 정보를 조회합니다.

```
이 토큰의 홀더가 몇 명이야?
```

### token\_get\_top\_holders

상위 토큰 홀더 목록을 조회합니다.

```
이 토큰의 상위 10명 홀더를 보여 줘
```

### token\_get\_pools

토큰의 유동성 풀을 조회합니다.

```
이 토큰의 유동성 풀이 어떤 DEX에 있어?
```

### token\_get\_security

토큰 보안 검사 결과를 조회합니다.

```
이 토큰이 안전한지 확인해 줘
```

### token\_get\_creation

토큰 생성 정보를 조회합니다.

```
이 토큰은 언제 생성됐어? 누가 만들었어?
```

### token\_get\_mint\_and\_burn

토큰 발행 및 소각 이력을 조회합니다.

```
이 토큰의 발행 및 소각 이력을 보여 줘
```

### token\_list

토큰 목록을 조회합니다 (페이지네이션 및 필터 지원).

```
Solana에서 최근 생성된 토큰 목록을 보여 줘
```

### token\_get\_traders\_tag

토큰의 트레이더 태그 분포를 조회합니다.

```
이 토큰을 거래하는 트레이더 유형을 분석해 줘
```

### token\_get\_liquidity\_snapshots

토큰 유동성 스냅샷을 조회합니다.

```
이 토큰의 지난 1주일간 유동성 변화를 보여 줘
```

### token\_dev\_get\_tokens

개발자가 생성한 모든 토큰을 조회합니다.

```
이 개발자가 만든 다른 토큰은 뭐가 있어?
```

***

## Wallet 도구

### wallet\_get\_balance

지갑 잔액을 조회합니다.

```
주소 0x1234...abcd의 모든 토큰 잔액을 조회해 줘
```

### wallet\_get\_balance\_updates

지갑 잔액 변동 이력을 조회합니다.

```
이 지갑의 최근 자금 이동을 보여 줘
```

### wallet\_get\_pnl

지갑 손익 데이터를 조회합니다.

```
이 주소의 전체 수익률과 승률을 계산해 줘
```

### wallet\_calculate\_pnl

특정 조건의 지갑 PnL을 계산합니다.

```
이 주소의 지난 30일간 수익률을 계산해 줘
```

### wallet\_get\_stats

지갑 통계를 조회합니다.

```
이 지갑의 거래 스타일과 활동 수준을 분석해 줘
```

***

## Trade 도구

### trade\_get

거래 기록을 조회합니다.

```
0x...의 최근 20건 거래를 보여 줘
```

### trade\_get\_activities

거래 활동 스트림을 조회합니다.

```
이 토큰의 최근 거래 활동을 보여 줘
```

### trade\_get\_top\_traders

상위 트레이더를 조회합니다.

```
이 토큰에서 가장 수익이 높은 트레이더를 보여 줘
```

***

## DexPool 도구

### dexpool\_get

풀 정보를 조회합니다.

```
이 풀의 상세 정보를 보여 줘
```

### dexpool\_get\_snapshots

풀 스냅샷 이력을 조회합니다.

```
이 풀의 지난 24시간 유동성 변화를 보여 줘
```

***

## Ranking 도구

### ranking\_get\_hot\_tokens

인기 토큰 랭킹을 조회합니다.

```
오늘 가장 인기 있는 토큰 10개를 보여 줘
```

### ranking\_get\_new\_tokens

신규 토큰 목록을 조회합니다.

```
지난 1시간 내에 생성된 토큰을 보여 줘
```

### ranking\_get\_stocks

보유 중인 토큰(졸업 전)을 조회합니다.

```
Pump.fun에서 아직 본딩 커브에 있는 토큰은?
```

### ranking\_get\_final\_stretch

졸업 임박한 토큰을 조회합니다.

```
Pump.fun에서 곧 졸업하는 토큰은?
```

### ranking\_get\_migrated

졸업 완료된 토큰 목록을 조회합니다.

```
최근 Raydium으로 졸업한 토큰을 보여 줘
```

***

## Blockchain 도구

### blockchain\_list

지원하는 블록체인 목록을 조회합니다.

```
ChainStream이 지원하는 블록체인은?
```

### blockchain\_get\_latest\_block

최신 블록 정보를 조회합니다.

```
Ethereum의 최신 블록 번호는?
```

***

## Dex 도구

### dex\_list

지원하는 DEX 목록을 조회합니다.

```
Solana에서 지원하는 DEX는?
```

### dex\_get\_quote

거래 견적을 조회합니다.

```
1 SOL로 USDC를 얼마나 받을 수 있어?
```

### dex\_get\_route

최적 거래 경로를 조회합니다.

```
ETH에서 ARB로의 최적 경로를 찾아 줘
```

### dex\_swap

토큰 스왑을 실행합니다.

```
0.5 SOL을 BONK로 스왑해 줘
```

### dex\_create

트랜잭션을 생성합니다 (서명 필요).

```
USDC에서 ETH로의 트랜잭션을 생성해 줘
```

***

## DeFi 도구

### pumpfun\_create

Pump.fun에서 토큰을 생성합니다.

```
Pump.fun에서 새로운 토큰을 만들어 줘
```

### moonshot\_create

Moonshot에서 토큰을 생성합니다.

```
Moonshot에서 토큰을 만들어 줘
```

### moonshot\_submit\_create\_token

Moonshot 토큰 생성 트랜잭션을 제출합니다.

```
Moonshot 토큰 생성 트랜잭션을 제출해 줘
```

***

## Transaction 도구

### transaction\_send

서명된 트랜잭션을 전송합니다.

```
이 트랜잭션을 전송해 줘
```

### transaction\_get\_gas\_price

현재 가스 가격을 조회합니다.

```
Ethereum의 현재 가스 가격은 얼마야?
```

### transaction\_estimate\_gas\_limit

트랜잭션 가스 한도를 추정합니다.

```
이 트랜잭션에 가스가 얼마나 필요한지 추정해 줘
```

***

## RedPacket 도구

### redpacket\_create

홍바오를 생성합니다.

```
10 SOL로 100개로 나눈 홍바오를 만들어 줘
```

### redpacket\_claim

홍바오를 수령합니다.

```
이 홍바오를 수령해 줘
```

### redpacket\_get

홍바오 정보를 조회합니다.

```
이 홍바오의 상세 정보를 보여 줘
```

### redpacket\_get\_claims

홍바오 수령 기록을 조회합니다.

```
누가 이 홍바오를 수령했어?
```

***

## Webhook 도구

### webhook\_list\_endpoints

설정된 Webhook 엔드포인트 목록을 조회합니다.

```
내가 설정한 모든 Webhook을 보여 줘
```

### webhook\_create\_endpoint

새로운 Webhook 엔드포인트를 생성합니다.

```
토큰 생성 이벤트를 수신할 새 Webhook을 만들어 줘
```

### webhook\_update\_endpoint

Webhook 엔드포인트 설정을 업데이트합니다.

```
이 Webhook의 콜백 URL을 업데이트해 줘
```

### webhook\_delete\_endpoint

Webhook 엔드포인트를 삭제합니다.

```
이 Webhook을 삭제해 줘
```

### webhook\_get\_secret

Webhook 서명 시크릿을 조회합니다.

```
이 Webhook의 서명 시크릿을 가져와 줘
```

### webhook\_rotate\_secret

Webhook 서명 시크릿을 갱신합니다.

```
이 Webhook의 시크릿을 재생성해 줘
```

***

## WebSocket 구독

MCP 서비스는 다음 데이터에 대한 WebSocket 실시간 구독도 지원합니다:

### 구독 유형

| 유형               | 설명          | 예시 프롬프트                       |
| ---------------- | ----------- | ----------------------------- |
| Candles          | 실시간 가격 캔들   | "이 토큰의 1분봉을 구독해 줘"            |
| Token Stats      | 실시간 거래 통계   | "이 토큰의 거래 데이터를 실시간으로 모니터링해 줘" |
| New Tokens       | 신규 토큰 알림    | "Solana에서 새 토큰이 생기면 알려 줘"     |
| Token Metadata   | 신규 토큰 메타데이터 | "새 토큰의 상세 정보를 가져와 줘"          |
| Wallet Balance   | 잔액 변동       | "이 지갑의 잔액 변동을 모니터링해 줘"        |
| Wallet Trades    | 거래 알림       | "이 지갑이 거래하면 알려 줘"             |
| Trade Activities | 실시간 거래 스트림  | "이 토큰의 실시간 거래를 보여 줘"          |
| Pool             | 풀 상태        | "이 풀의 유동성 변화를 모니터링해 줘"        |
| Rankings         | 인기 토큰 업데이트  | "인기 토큰 랭킹 실시간 업데이트"           |

<Note>
  WebSocket 구독 파라미터 및 응답 형식에 대한 자세한 내용은 [WebSocket API 문서](/ko/api-reference/endpoint/websocket/api)를 참조하세요.
</Note>

***

## 지원 블록체인

| 체인       | 식별자   | 유형       |
| -------- | ----- | -------- |
| Solana   | `sol` | L1       |
| Ethereum | `eth` | L1 (EVM) |
| BSC      | `bsc` | L1 (EVM) |

***

## 프롬프트 모범 사례

### 체인 지정하기

```
✅ 좋은 예: Ethereum에서 0x...의 잔액을 조회해 줘
❌ 나쁜 예: 0x...의 잔액을 조회해 줘
```

### 전체 주소 제공하기

```
✅ 좋은 예: 0x1234567890abcdef1234567890abcdef12345678을 분석해 줘
❌ 나쁜 예: 0x1234...5678을 분석해 줘
```

### 시간 범위 지정하기

```
✅ 좋은 예: 지난 7일간의 거래 기록을 보여 줘
❌ 나쁜 예: 최근 거래를 보여 줘
```

### 복잡한 작업 분해하기

복잡한 작업은 간단한 질문으로 나누세요:

```
✅ 좋은 예:
1. 먼저 이 주소의 보유 내역을 조회
2. 그다음 거래 이력을 분석
3. 마지막으로 투자 스타일을 판단

❌ 나쁜 예:
이 주소에 대해 전부 다 알려 줘
```

### 후속 질문에 컨텍스트 활용하기

```
사용자: 0x...의 보유 내역을 조회해 줘
AI: [보유 목록 반환]
사용자: 이 중에서 어떤 토큰이 수익률이 제일 높아?
사용자: PEPE를 보유하고 있는 이유를 분석해 줘
```

***

## 관련 문서

<CardGroup cols={2}>
  <Card title="MCP 소개" icon="plug" href="/ko/docs/ai-agents/mcp-server/introduction">
    MCP 프로토콜과 기능 알아보기
  </Card>

  <Card title="설정 가이드" icon="gear" href="/ko/docs/ai-agents/mcp-server/setup">
    MCP Server 설정하기
  </Card>

  <Card title="API Reference" icon="code" href="/ko/api-reference/authentication/authenticate">
    전체 REST API 문서
  </Card>

  <Card title="WebSocket API" icon="bolt" href="/ko/api-reference/endpoint/websocket/api">
    실시간 데이터 구독
  </Card>
</CardGroup>
