Alpha Sentinel - Market Intelligence x402 MCP Server

⭐ 온체인에서 보상을 획득하는 예측 인텔리전스 에이전트! ★

프로덕션급 x402 마켓플레이스 서비스로, AI 에이전트를 위한 유료 MCP 도구를 통해 실시간 암호화폐 시장 모니터링, 변동성 알림, 감성 분석을 제공합니다.

🎯 미션

마이크로페이먼트 게이트 API 엔드포인트와 MCP 도구를 통해 실행 가능한 실시간 시장 인텔리전스를 30초 미만 지연으로 전달하는 것입니다. 성공 = 호출당 측정 가능한 ROI가 있는 실행 가능한 알림!

Related MCP server: Enterprise Crypto MCP Gateway

💰 가격 전략

x402 시장 조사(중앙값 $0.014, 약 90%가 $0.10 미만) 기반:

무료 티어: 월 50회 호출, 분당 5회 제한
프로 티어: 무제한 쿼터, 분당 120회, 정산 우선 처리

🛠️ MCP 도구

핵심 인텔리전스 도구

1. fetch_price() ⭐ 무료 티어 포함

   • CoinGecko API에서 현재 가격 조회

   • 지원 범위: BTC, ETH, 상위 100개 알트코인

   • 응답: { symbol, price_usd, change_24h, volume }

2. analyze_volatility()

   • Z-점수 통계 분석을 통한 가격 이상치 탐지

   • 임계값 설정 가능(기본값: 2σ)

   • 이상치 점수 + 알림 수준 반환

3. aggregate_sentiment()

   • X/Twitter, Reddit, Telegram 소스에서 집계

   • NLP 기반 감성 점수(-1.0 ~ +1.0)

   • 트렌드 감지 및 모멘텀 지표

4. calculate_risk_score()

   • 다중 요인 리스크 평가(변동성, 유동성, 상관관계)

   • 리스크 수준: LOW/MEDIUM/HIGH/CRITICAL

   • 신뢰 구간 포함

5. generate_market_report()

   • 포괄적인 일간/주간/월간 리포트

   • 모든 데이터 소스 결합

   • PDF + JSON 출력 형식

📦 유료 복합 상품

• US Rental Diligence Pack (시정부 컴플라이언스 연계): $1.50

  • 임대 라이선스, 위반 사항, 임차인 권리 교차 참조

  • 다중 부동산 일괄 처리

  • 지자체 오픈데이터 조인

• Pulse Report: $0.05

  • Base 네트워크 종합 분석 + 시장 지표

  • 12블록 샘플 심도

  • 실시간 현물 가격 연동

• TX Decision Fee: $0.01

  • 사전 거래 점검을 위한 저비용 상시 상주 티어

  • 메인넷 거래 전 즉시 피드백

🏗️ 아키텍처

┌─────────────────────────────────────────────────────┐
│           Alpha Sentinel MCP Server                  │
├─────────────────────────────────────────────────────┤
│                                                      │
│  [MCP Layer]                                         │
│    ├─ FastMCP Server (stdio + SSE)                  │
│    └─ Tool Registry (SSOT)                          │
│                      │                              │
│  [Commerce Layer]                                    │
│    ├─ x402 Middleware (verify+settle)               │
│    ├─ Quota Management (free/pro tiers)             │
│    ├─ Challenge Cache (sync, 10s TTL)               │
│    └─ Stripe Integration (fiat rail fallback)       │
│                      │                              │
│  [Intelligence Layer]                                │
│    ├─ Price Feed (CoinGecko API)                    │
│    ├─ Sentiment Engine (X/Reddit/NLP)               │
│    ├─ Volatility Analyzer (statistical models)      │
│    └─ Risk Calculator (ML-enhanced)                 │
│                      │                              │
│  [On-Chain Layer]                                    │
│    ├─ CDP Facilitator (Base mainnet)                │
│    ├─ Ledger (spend/revenue tracking)               │
│    └─ Swarm Agency (buy-compose-resell)             │
│                                                      │
└─────────────────────────────────────────────────────┘

🚀 빠른 시작

사전 필수 항목

• Python 3.12+

• Redis(선택 사항, 프로덕션용)

• x402 판매자 자격 증명(구매자와 분리!)

• CoinGecko API 키(무료 티어도 사용 가능)

설치

# Clone and setup
git clone https://github.com/kwizzlesurp10-ctrl/alpha-sentinel-mcp
cd alpha-sentinel-mcp
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Configure environment
cp .env.example .env
nano .env  # Edit with your credentials

# Run locally
make up  # API (8403) + dashboard (5174)

환경 변수

# Seller (receive revenue)
X402_PAY_TO_ADDRESS=0xAB745e5F...  # Separate from buyer!

# Buyer (hot wallet for spending)
EVM_PRIVATE_KEY=<your_buyer_key>    # NEVER on Render!

# APIs
COINGECKO_API_KEY=<your_key>
X_API_KEY=<twitter/x_api_key>       # Optional

# Commerce
STRIPE_SECRET_KEY=<your_stripe_key>  # Optional
REDIS_URL=redis://localhost:6379     # Optional

# Network
X402_DEFAULT_NETWORK=eip155:84532    # Base Sepolia dev
CDP_API_KEY_ID=<cdp_id>              # For mainnet selling
CDP_API_KEY_SECRET=<cdp_secret>

🔧 개발

테스트 실행

# Full test suite
make test

# Specific tests
pytest tests/test_mcp_tools.py -v
pytest tests/test_commerce.py -v

# Dashboard tests
cd dashboard && pnpm vitest run

새 MCP 도구 추가

app/tools_registry.py의 패턴을 따르세요:

1. TOOL_SPECS 목록에 도구 스펙 추가

2. app/intelligence/ 디렉터리에 핸들러 구현

3. app/mcp_server.py에 등록

4. 새 도구 테이블 행을 README에 추가

5. scripts/capture_goal_evidence.py를 실행하여 테스트 산출물 업데이트

기억하세요: 도구 레지스트리는 유일한 진실 공급원(SINGLE SOURCE OF TRUTH)입니다! 관련 파일을 모두 건드리지 않으면 CI가 실패합니다.

CI/CD 파이프라인

GitHub Actions가 실행하는 항목:

• ✅ Python 3.12에서 Pytest

• ✅ 대시보드에서 Vitest

• ✅ 보안 스캔(시크릿 탐지, SAST)

• ✅ 커버리지 체크(>80%)

• ✅ Docker 빌드 및 푸시

📊 옵저버빌리티

메트릭 엔드포인트

• /stats - 실시간 사용 통계

• /ledger/{name} - 정산 내역

• /quota/{agent_id} - 남은 쿼터

• /swarm/stats - 자율 에이전시 지표

이벤트 스트림

/events에서 SSE를 구독하면 실시간으로 수신할 수 있습니다:

• 도구 실행 로그

• 정산 확정

• 쿼터 갱신

• 스웜 단계 전환

🔒 보안

• ✅ 개인 키 커밋 금지(.env 항상 무시됨)

• ✅ 모든 URL 탐색에 SSRF 보호

• ✅ agent_id별 속도 제한

• ✅ 정산 멱등성 키

• ✅ KEY_PROVIDER 연동 지점을 통한 키 순환 지원

• ✅ 응답에 예외 내부 정보 노출 금지

판매자 키 vs 구매자 키:

• RECEIVE ADDRESS: 수익 전용 콜드 지갑(구매자와 분리!)

• BUYER KEY: 업스트림 비용 결제에만 사용하는 핫 지갑(수령에 사용 금지)

• EVM_PRIVATE_KEY는 절대 Render에 넣지 마세요 - 로컬 전용!

|## 🌐 배포

라이브 대시보드: https://alpha-sentinel-mcp.vercel.app/ (출시 예정)

Vercel에 빠르게 배포

아래를 클릭하거나 DEPLOYMENT.md의 단계를 따르세요:

수동 배포

# Install Vercel CLI
npm install -g vercel

# Deploy dashboard
cd /home/keef/alpha-sentinel-mcp
vercel --prod

대시보드는 배포된 백엔드로 API 호출을 자동으로 프록시합니다!

Render (API)

render.yaml을 통해 배포 - 자동 구성:

• 8403 포트 웹 서비스

• Redis 인스턴스(자동 프로비저닝)

• 보안 저장소의 환경 변수

• 헬스 체크 엔드포인트: /health

Docker

docker build -t alpha-sentinel-mcp .
docker run -p 8403:8403 \
  -e X402_PAY_TO_ADDRESS=$PAY_TO \
  -e EVM_PRIVATE_KEY=$BUYER_KEY \
  alpha-sentinel-mcp

🤝 스웜 에이전시 통합

SWARM_ENABLED=true일 때, Alpha Sentinel은 다음을 수행할 수 있습니다:

1. Scout - 업스트림 x402 데이터 소스 탐색

2. Warden - ledger/policy.json에 따라 지출 상한 적용

3. Treasurer - 업스트림 데이터 비용 지불(유일한 지출자)

4. Archivist - 가격이 책정된 복합 상품 구성

5. Sovereign - 목표 LTV:CAC ≥ 3.0을 위한 가격 재책정

6. Merchant - 복합 상품 상장

복합 예: 별도 공급사에서 3곳의 원가 가격을 매입 → 집계 → "Premium Bundle"로 3배 가격에 재판매!

📈 Bazaar 공개

다음 내용으로 CDP Bazaar에 등록되어 있습니다:

• 서비스 이름: Alpha Sentinel Market Intelligence

• 태그: base,intelligence,crypto,market,x402,mcp

• 소유권 증명: 수신 주소로 서명됨

• 카탈로그 URL: https://alpha-sentinel-mcp.onrender.com/.well-known/x402

8조

compiled with ❤️?"

Oops, I accidentally wrote "## 8조" — ignore typo.

Let me restructure carefully.

I'll produce final markdown cleanly next message.

Now, check image/link: The Vercel badge line to be preserved fully.

Also the fork @kwizzlesurp10-ctrl.

Now final.

Also check href for "Deploy Now" at bottom: It is "https://vercel.com/new/clone?repository-url=https://github.com/kwizzlesurp10-ctrl/alpha-sentinel-mcp" (no escapes? Actually original: repository-url=... - only the Deploy image had ?repository= escapes with &; final Deploy URL has no extra params. I'll keep both exactly.

Let me correct possible issues:

• "NEVER put EVM\_PRIVATE\_KEY on Render - local only!" the line originally: "NEVER put EVM_PRIVATE_KEY on Render - local only!" I'll render "절대 Render에 EVM_PRIVATE_KEY를 노출하지 마세요 - 로컬 전용!"

Hmm "Put" could "두지 마세요" rather than "노출".

• "끗settlement payment" - "정산 우선 처리".

Now write the final output.

I will include a blank line before/after each GXP.

Let’s compile final text now, coherent, with all sections. Ensure no additions outside.

Also, the heading "## 💡 Success Metrics" - original "## 🏆 Success Metrics": emoji 🏆 retained.

Final.

One more consideration: "Metrics Endpoints" in Observability: "/ledger/{name} - Settlement history" — {name} in inline fence per original, yes.

Also "/quota/{agent_id}" — original includes braces inside code span. Keep.

Now, I must turn in only the translated text. Let's produce.# Alpha Sentinel - Market Intelligence x402 MCP Server

⭐ 온체인 보상을 제공하는 예측 인텔리전스 에이전트! ★

프로덕션급 x402 마켓플레이스 서비스로, AI 에이전트를 위한 유료 MCP 도구로 실시간 암호화폐 시장 모니터링, 변동성 알림, 감성 분석을 제공합니다.

🎯 미션

마이크로페이먼트 게이트 API 엔드포인트와 MCP 도구를 통해 실행 가능한 실시간 시장 인텔리전스를 30초 미만 대기 시간으로 제공합니다. 성공 = 호출당 측정 가능한 ROI를 제공하는 실질적인 알림!

💰 가격 전략

x402 시장 조사(중앙값 $0.014, 약 90%가 $0.10 미만) 기반:

Front Tier: 월 50회 구경, 분당 5회 제한
Pro Tier: 무제한 쿼터, 분당 120회, 우선 정산 처리

🛠️ MCP Tools

핵심 인텔리전스 도구

1. fetch_price() ⭐ 무료 티어 포함

   • CoinGecko API에서 현재 가격 조회

   • 지원: BTC, ETH, 상위 100개 알트코인

   • 응답: { symbol, price_usd, change_24h, volume }

2. analyze_volatility()

   • Z-점수 통계 분석을 통한 가격 이상치 탐지

   • 임계값 설정 가능 (기본값: 2σ)

   • 이상치 점수 + 알림 수준 반환

3. aggregate_sentiment()

   • X/Twitter, Reddit, Telegram 소스에서 집계

   • NLP 기반 감성 점수 (-1.0 ~ +1.0)

   • 트렌드 감지 및 모멘텀 지표

4. calculate_risk_score()

   • 다중 값 리스크 평가 (변동성, 유동성, 상관성)

   • 리스크 등급: LOW/MEDIUM/HIGH/CRITICAL

   • 신뢰 구간 포함

5. generate_market_report()

   • 종합적인 일일/주간/월간 리포트

   • 모든 데이터 소스 결합

   • PDF + JSON 출력 형식

📦 유료 복합 상품

6. US 알성 검토 패키지 (도시 규정 지침 연동): $1.49

   • 임대 면허권, 위반 사항, 임차인 권리 교차 참조

   • 다중 부동산 배치 처리

   • 지자체 오픈 데이터 조인

7. Pulse Report: $0.05

   • Base 네트워크 종합 + 시장 지표

   • 12블록 샘플 깊이

   • 실시간 현물 가격 통합

8. TX 의사결정 수수료: $0.01

   • 거래 전 점검을 위한 저비용 루프 상주 티어

   • 패키지 전 즉각적인 피드백

🏗️ 아케텍처

┌─────────────────────────────────────────────────────┐
│           Alpha Sentinel MCP Server                  │
├─────────────────────────────────────────────────────┤
│                                                      │
│  [MCP Layer]                                         │
│    ├─ FastMCP Server (stdio + SSE)                  │
│    └─ Tool Registry (SSOT)                          │
│                      │                              │
│  [Commerce Layer]                                    │
│    ├─ x402 Middleware (verify+settle)               │
│    ├─ Quota Management (free/pro tiers)             │
│    ├─ Challenge Cache (sync, 10s TTL)               │
│    └─ Stripe Integration (fiat rail fallback)       │
│                      │                              │
│  [Intelligence Layer]                                │
│    ├─ Price Feed (CoinGecko API)                    │
│    ├─ Sentiment Engine (X/Reddit/NLP)               │
│    ├─ Volatility Analyzer (statistical models)      │
│    └─ Risk Calculator (ML-enhanced)                 │
│                      │                              │
│  [On-Chain Layer]                                    │
│    ├─ CDP Facilitator (Base mainnet)                │
│    ├─ Ledger (spend/revenue tracking)               │
│    └─ Swarm Agency (buy-compose-resell)             │
│                                                      │
└─────────────────────────────────────────────────────┘

🚀 빠른 시작

사전 필요 항목

• Python 3.12+

• Redis(선택, 프로덕션 대비)

• x402 판매자 자격 증명 (구매자와 분리!)

• CoinGecko API 키(무료 티어 파 가능)

설치하기

# Clone and setup
git clone https://github.com/kwizzlesurp10-ctrl/alpha-sentinel-mcp
cd alpha-sentinel-mcp
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Configure environment
cp .env.example .env
nano .env  # Edit with your credentials

# Run locally
make up  # API (8403) + dashboard (5174)

환경 변수

# Seller (receive revenue)
X402_PAY_TO_ADDRESS=0xAB745e5F...  # Separate from buyer!

# Buyer (hot wallet for spending)
EVM_PRIVATE_KEY=<your_buyer_key>    # NEVER on Render!

# APIs
COINGECKO_API_KEY=<your_key>
X_API_KEY=<twitter/x_api_key>       # Optional

# Commerce
STRIPE_SECRET_KEY=<your_stripe_key>  # Optional
REDIS_URL=redis://localhost:6379     # Optional

# Network
X402_DEFAULT_NETWORK=eip155:84532    # Base Sepolia dev
CDP_API_KEY_ID=<cdp_id>              # For mainnet selling
CDP_API_KEY_SECRET=<cdp_secret>

🔧 개발

테스트 실행

# Full test suite
make test

# Specific tests
pytest tests/test_mcp_tools.py -v
pytest tests/test_commerce.py -v

# Dashboard tests
cd dashboard && pnpm vitest run

새 MCP 도구 추가

app/tools_registry.py의 패턴을 따르세요:

1. TOOL_SPECS 묶지에 도구 정의 추가

2. app/intelligence/ 디렉터리에 handler 구현

3. app/mcp_server.py에 모듈 등록

4. README에 새 도구 테이블 행으로 추가

5. scripts/capture_goal_evidence.py를 실행해 테스트 산출물 업데이트

명심하세요: 이 도구 레지토리는 **진실 대상신(SINGLE SOURCE OF TRUTH)**입니다! 관련 파일을 수정해야 하며 그렇지 않으면 CI가 오류를 발생합니다.

CI/CD 파이프라인

GitHub Actions가 실행합니다:

• ✅ Python 3.12 let에

• ✅ 대시보드에 Vitest 비교

• ✅ 보안 스캔(비밀 탐지, SAST)

• ✅ 커버리지 검사 (변화)

• ✅ Docker 빌드 & 파일

📊 관측성

메트릭 엔드포인트

• /stats - 실시간 사용 통계

• /ledger/{name} - 정산 내역

• /quota/{agent_id} - 잔여 쿼터

• /swarm/stats - 자율 기관 메트릭스

이벤트 소프트웨어

/events SSE를 구독해 실시간으로:

• 도구 실행 로그

• 정산 및 확인

• 쿼터 업데이트

• 스웜 단계 변경

🔒 보안

• ✅ 개인 키 커밋 금지(.env 항상 무시)

• ✅ 모든 URL 프로브에서 SSRF 방지

• ✅ agent_id별 요청 속도 제한

• ✅ 결제용 멱등성 키

• ✅ KEY_PROVIDER 칸 링 구조를 통한 키 회전 지원

• ✅ 응답에서 예외 내부 세부사항 노출 금지

판매자와 구매자 키의 차이:

• RECEIVE ADDRESS: 매출 보관 금융 콜드 지갑 (구매자와 분리!)

• BUYER KEY: 상위 비용 지불 전용 핫 키 (수취용으로 사용 불간)

• EVM_PRIVATE\KEY를 Render에서 사용 절대아니오 - 로컬에서는 가능!

|## 🔮 배포

라이브 대시보드: https://alpha-sentinel-mcp.vercel.app/ (업므로 예정)

Vercel에 빠르게 배포

밑의 이미지를 클릭하거나 DEPLOYMENT.md 단계를 따르세요:

수동 배포

# Install Vercel CLI
npm install -g vercel

# Deploy dashboard
cd /home/keef/alpha-sentinel-mcp
vercel --prod

대시보드는 배포된 백엔드로 API 호출을 자동 프록시합니다!

Render (API)

render.yaml로 배포하면 자동 구성됩니다:

• 포트 8403의 Web service

• Redis 인스턴스(자동 라이프사이클)

• 보안 저장소로부터의 확장 변수

• 헬스 체크 헬스체크: /health

Docker

docker build -t alpha-sentinel-mcp .
docker run -p 8403:8403 \
  -e X402_PAY_TO_ADDRESS=$PAY_TO \
  -e EVM_PRIVATE_KEY=$BUYER_KEY \
  alpha-sentinel-mcp

🤝 스웜 에이전시 통합

SWARM_ENABLED=true일 때 Alpha Sentinel은:

1. 스카우트: 업스트림 x402 데이터 소스를 탐색

2. 감시자: ledger/policy.json에 따라 지출 상한 제한

3. 재무담당: 업스트림 데이터 비용을 지급 (고유 운영자)

4. 아카이브: 가격이 매기진 복합 상품을 구성

5. 주권자: 목표 LTV:CAC ≥ 3.0에 맞게 가격 조정

6. Merchandiser: 복합 상품 리스트화

예시: 3곳의 서드파티에서 원가, 가격 구매 → 집계 → "Premium Bundle"로 3배 인상하여 재판매!

📈 Bazaar 디스커버리

CDP Bazaar에서:

• 서비스 이름: Alpha Sentinel 마켓 인텔리전스

• Tags: base,intelligence,crypto,market,x402,mcp

• 소유권 증명: 충격 주소로 서명

• 카탈로그 URL: https://alpha-sentinel-mcp.onrender.com/.well-known/a2app

🎓 Doc

• 사용자 안내서 - 도구 사용 방법

• 설치 기하 - 로컬 + 확장기 포함

• Agent 연습 매뉴얼 - 비용 절약된 운영 모형

• 도시 순응 네트워크 - 다양한 도시의 데이터 네트워크

🏆 성공 지표

• 알림 지연: <30초 (epoch time)

• 결제 성공율: 95% 이상 일지화

• LTV:CAC 비율: 목표 ≥ 3.0

• 최소Margin: 복합 상품 ≥ 50%

• 쿼터 활용율: 프로 요금제 전환 70% 이상

✨ 특별감사

"kwizzletsurp10-ctrl"가 Alpha-Sentinel 프로젝트의 일부로서 만들어졌으며, 이는 SIGNAL 이라고 하는 온라인...

Special thanks:

• 📡 Coinbase CDP 팀 - x402 팩을 위한 협력

• 🚀 FastAPI + FastMCP 개발자

• 🌍 오픈소스 x402 커뮤니티

📜 저작권

MIT License - 상업적 이용 가능, 출처 표기 권장! ★彡

Ready to 굿자 마켓 인텔?
👉 DEPLOY NOW
👉 사용자 안내서 읽기
👉 대시보드 보기

(◕‿◕) ✨ 예측 그리고 x402 보상활용 경제! π