엔드포인트
- URL:
https://mcp.chainstream.io/mcp - 전송(Transport): Streamable HTTP (수평 스케일링 + 진행 상황 리포팅)
- 인증: Bearer 토큰 (
X-API-KEY) 또는 x402 마이크로페이먼트 (Base / Solana의 USDC)
두 가지 도구 표면
ChainStream은 MCP 서버를 두 가지 형태로 제공합니다. 에이전트 워크플로우에 맞는 것을 선택하세요.| 표면 | 명명 규칙 | 사용 시점 |
|---|---|---|
| 결과 지향 도구(Outcome-oriented tools) | tokens_search, dex_swap (언더스코어) | 사용자 대면 작업을 수행하는 에이전트용 — 각 도구가 여러 REST 호출을 오케스트레이션하여 큐레이션된 결과를 반환합니다. Agent Skills가 참조하는 도구입니다. |
| 플레이그라운드 도구(Playground tools) | getToken, createEndpoint (camelCase) | 프로그래머틱 사용을 위한 REST API 1:1 커버리지 — REST와 동일한 입출력, 테스트와 저수준 자동화에 이상적 |
리소스
| URI | 내용 |
|---|---|
chainstream://chains | 지원 체인 및 상태 |
chainstream://chains/{chain}/dexes | 체인의 DEX 프로토콜 |
chainstream://docs/api_reference | 전체 REST API 레퍼런스 (모든 /v2/* 엔드포인트) |
chainstream://docs/query_examples | 에이전트용 공통 쿼리 패턴 |
리스크 모델
각 도구는 리스크 레벨로 태그되어 있습니다. 클라이언트는 L2 이상의 도구를 명시적 확인 UI 뒤에 노출해야 합니다.| 레벨 | 의미 |
|---|---|
| L0 | 읽기 전용, 무상태 — 자동 호출 안전 |
| L1 | 읽기 전용, 사용자 범위 (지갑 프로필, 웹훅 리스트) — 안전하나 개인적 |
| L2 | 읽기 전용이나 연산 비용이 큼 (백테스트) — 비용 발생 가능 |
| L3 | 쓰기 / 서명 / 브로드캐스트 — 명시적 사용자 확인 필수 |
결과 지향 도구 (17개)
토큰 인텔리전스
| 도구 | 설명 | 주요 파라미터 | 리스크 |
|---|---|---|---|
tokens_search | 지원되는 모든 체인에서 이름, 심볼, 주소로 토큰 검색 | query, chain? | L0 |
tokens_analyze | 종합적 토큰 분석: 가격, 거래량, 홀더, 보안, 유동성 | chain, address | L0 |
tokens_price_history | 차트와 기술적 분석을 위한 OHLCV 캔들스틱 데이터 | chain, address, resolution, from?, to? | L0 |
tokens_discover | 온체인 메트릭(거래량, 가격 변동, 거래 횟수)으로 토큰 발견 | chain, 필터 | L0 |
tokens_compare | 최대 5개 토큰의 병렬 비교 | chain, addresses[] | L0 |
지갑 인텔리전스
| 도구 | 설명 | 주요 파라미터 | 리스크 |
|---|---|---|---|
wallets_profile | 전체 지갑 프로필 — 보유, PnL, 순자산을 한 번의 호출로 | chain, address | L1 |
wallets_activity | 최근 지갑 전송 및 잔고 변동 | chain, address, limit? | L1 |
시장 탐색
| 도구 | 설명 | 주요 파라미터 | 리스크 |
|---|---|---|---|
market_trending | 카테고리별 트렌딩 토큰 (hot, new, migrated, graduating, stocks) | chain, category, duration | L0 |
trades_recent | 토큰 또는 지갑의 최근 온체인 거래 | chain, token?, wallet?, limit? | L0 |
DEX 및 트레이딩
| 도구 | 설명 | 주요 파라미터 | 리스크 |
|---|---|---|---|
dex_quote | 예상 출력, 가격 영향, 수수료 포함 스왑 견적 (읽기 전용) | chain, from, to, amount | L0 |
dex_swap | DEX에서 토큰 스왑 실행 | chain, from, to, amount, slippage | L3 |
dex_create_token | 런치패드에 토큰 생성 | chain, name, symbol, dex, uri | L3 |
trading_backtest | 히스토리 데이터에 대해 전략 백테스트 | 전략 명세 | L2 |
trading_execute | 전략 거래 실행 | chain, strategy, params | L3 |
transaction_send | 서명된 트랜잭션 브로드캐스트 | chain, signed_tx | L3 |
운영(Ops)
| 도구 | 설명 | 주요 파라미터 | 리스크 |
|---|---|---|---|
webhooks_manage | 웹훅 엔드포인트 관리 (조회, 생성, 삭제) | action, 엔드포인트 명세 | L1 |
blockchain_info | 지원 체인 및 DEX 프로토콜 | — | L0 |
KYT / 컴플라이언스는 결과 지향 도구로 래핑되어 있지 않습니다 —
/v1/kyt/* 아래의 REST API를 직접 호출하세요. KYT 개념을 참고하세요.플레이그라운드 도구 (REST 동등)
플레이그라운드 표면은 REST API를 MCP 도구로 1:1 미러링합니다. 모든 도구는 해당 REST 엔드포인트와 동일한 JSON 파라미터를 받아 원시 응답을 담은content[0].text JSON 문자열을 반환합니다. REST와의 프로그래머틱 동등성이 필요하지만 MCP 경로로 라우팅하고 싶을 때 사용하세요.
blockchain
blockchain
getBlockchainList, getBlockchainLatestBlocktoken
token
getToken, getTokens, searchTokens, getTokenMetadata, getTokensMetadata, getTokenLiquidityPools, getTokenStats, getTokensStats, getTokenHolders, getTokenHoldersMulti, getTokenCandles, getTokenTopHolders, getTokenMarketData, getTokensMarketData, getTokenPrices, getTokenPriceByTime, getTokenCreation, getTokenMintBurn, getTokenSecurity, getTokenListFiltered, getDevTokens, getTokenTraders, getTokenLiquiditySnapshots, getTokenTransfers, getTokenTransferTotal, getPairCandles, getPoolCandleswallet
wallet
getTokensBalance, getPnl, getPnlDetails, getPnlByToken, getPnlByWallet, calculatePnl, getNetWorth, getNetWorthDetails, getNetWorthChart, getNetWorthByTokens, getNetWorthSummary, getBalanceUpdates, getWalletTransfers, getWalletTransferTotal, getWalletFirstTxtrade
trade
getTradeList, getTradeTopTraders, getTradeGainersLosers, getTradeActivityListranking
ranking
getHotTokens, getRankingNewTokens, getRankingStocksTokens, getRankingFinalStretchTokens, getRankingMigratedTokensdexpool
dexpool
getDexpoolDetail, getDexpoolSnapshotsdex
dex
getDexList, getQuote, getRoute, swap, createTokendefi
defi
pumpfunCreateToken, moonshotCreateTokentransaction
transaction
sendTransaction, getGasPrice, estimateGasLimitkyt
kyt
registerTransfer, getTransferSummary, getTransferAlerts, getTransferDirectExposure, getTransferNetworkIdentifications, registerWithdrawal, getWithdrawalSummary, getWithdrawalAlerts, getWithdrawalDirectExposure, getWithdrawalFraudAssessment, getWithdrawalAddressIdentifications, getWithdrawalNetworkIdentifications, registerAddress, getAddressRiskwebhook
webhook
listEndpoints, createEndpoint, getEndpoint, updateEndpoint, deleteEndpoint, getEndpointSecret, rotateEndpointSecretredpacket
redpacket
getRedpacketCreate, getRedpacketClaim, getRedpacketGet, getRedpacketGetClaims, getRedpacketGetList, getRedpacketGetClaimsByAddress, getRedpacketGetByAddress, getRedpacketSendwatchlist
watchlist
watchlistAddipfs
ipfs
presign클라이언트 설정 예시
- Cursor / VS Code
- Claude Desktop
다음 단계
MCP Server 소개
MCP란 무엇이며 ChainStream이 어떻게 노출하는지.
MCP Server 설정
Cursor, Claude Desktop 등에 서버 연결.
x402 결제
자율 에이전트를 위한 콜당 과금 인증.
Agent Skills
MCP와 CLI 위에 계층화된 상위 레벨 SKILL.md 패키지.

