프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

Crypto Regime MCP

제작자: Shicodiez버전 0.1.4i★ 1i컴퓨터 또는 클라우드공식 사이트 ↗
레지스트리 이름io.github.Shicodiez/crypto-regime-mcp

설치 방법

What it does

Crypto trend and regime MCP tools with automatic x402 payments or prepaid credits.

  • Connects 컴퓨터 또는 클라우드
  • Account or key Cloud: No key needed · Local: Needs EVM_PRIVATE_KEY
  • Category 암호화폐 및 블록체인

이 순위인 이유

목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다

인기4/80GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20
최신성12/1230일 안에 릴리스나 코드 변경이 있으면 만점
응답 중8/8마지막 점검 때 클라우드 엔드포인트가 응답
사용 점수24/100

품질: 기본 점검 5/5개 통과(표시만, 정렬에는 안 씀) · 상승세: 데이터 없음 (급상승 탭에서만 사용)

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

한 문장으로 AI에게 설치 맡기기

Crypto Regime MCP 설치해 줘. https://mcp.popnx.com/i/shicodiez-crypto-regime-mcp.md 를 따라 하고, 명령을 먼저 보여 주고 내가 승인하면 실행해.

내 컴퓨터에서 작업하는 AI(Claude Code, Cursor 등)에 붙여 넣으세요. 단계를 읽고 명령을 보여 준 뒤 승인을 기다립니다. 키도 가입도 필요 없습니다. · AI가 읽을 전체 내용 보기

검사 5/5 통과 · 내가 묻는 내용은 제작자 서버(signal-api.shicoars.workers.dev)를 거쳐요 · ✓ 명령 확인 2026년 11월 14일

먼저: 어떤 AI를 쓰시나요?

쓰는 앱을 고르면 아래에 단계가 나옵니다.

Claude에 연결할 수 있어요 · 약 2분

키 필요 없음, 설치 필요 없음 · claude.ai나 데스크톱 앱에서 한 번 설정하면 채팅에서 쓸 수 있어요 · 무료 계정은 1개까지 · Team/Enterprise는 소유자(Owner)가 추가

  1. Claude의 Connectors 페이지 열기

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. “Add” → “Custom” → “Web”를 누르고 이 2칸 채우기

    여기서 복사해 Claude의 같은 이름 칸에 붙여 넣고 Continue를 누르세요

    Name · 이름Crypto Regime MCP
    Remote MCP server URL · 주소https://signal-api.shicoars.workers.dev/mcp

    Claude가 찾은 로그인 설정 화면에서 Continue를 누르고 · Authentication은 제작자 안내대로(Sign in now, Sign in when needed, No sign in) 고른 뒤 Add를 누르세요

  3. 채팅에서 켜기

    +ConnectorsCrypto Regime MCP

  4. 해 보기

    Crypto Regime MCP을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Claude가 Crypto Regime MCP을 쓰고 있다고 하거나 답에 Crypto Regime MCP 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

ChatGPT 연결은 요금제에 따라 달라요

전체 MCP: 웹 ChatGPT Business, Enterprise, Edu · Pro: 읽기/가져오기 권한으로 연결, 데이터를 바꾸는 도구는 안 될 수 있어요 · Plus: 공식 문서 미확인, 플러그인 화면에 사용자 지정 MCP 추가 항목이 보이면 시도해 볼 수 있어요 · 웹만

  1. 웹 ChatGPT에서 MCP 추가 페이지 열기

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 이름과 주소 입력

    이름을 넣고 Connection에 주소를 붙여 넣은 뒤 경고에 체크하고 Create as a plugin을 누르세요

    Name · 이름Crypto Regime MCP
    Connection · 주소https://signal-api.shicoars.workers.dev/mcp
  3. 채팅에서 Crypto Regime MCP 고르기

    새 채팅을 열고 입력 전에 플러그인 목록에서 Crypto Regime MCP을 고르세요

  4. 해 보기

    Crypto Regime MCP을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ ChatGPT가 Crypto Regime MCP을 쓰고 있다고 하거나 답에 Crypto Regime MCP 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 OpenAI 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Claude Code에 연결할 수 있어요 · 약 2분

키 필요 없음, 설치 필요 없음

  1. 터미널 열기

    Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기

  2. 이 명령을 붙여 넣고 Enter

    claude mcp add --transport http --scope user crypto-regime https://signal-api.shicoars.workers.dev/mcp
  3. Claude Code에서 /mcp 입력

    Crypto Regime MCP이 목록에 있고 연결됨으로 보이면 돼요

  4. 해 보기

    Crypto Regime MCP을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Claude Code가 Crypto Regime MCP을 쓰고 있다고 하거나 답에 Crypto Regime MCP 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Cursor에 연결할 수 있어요 · 약 2분

키 필요 없음, 설치 필요 없음

  1. 이 버튼으로 Cursor 열기

    Cursor에서 열기

    Cursor가 설치를 확인하면 Install을 누르세요

  2. Cursor에서 AI 채팅을 Agent 모드로 열기

  3. 해 보기

    Crypto Regime MCP을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Cursor가 Crypto Regime MCP을 쓰고 있다고 하거나 답에 Crypto Regime MCP 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

VS Code에 연결할 수 있어요 · 약 2분

키 필요 없음, 설치 필요 없음

  1. 이 버튼으로 VS Code 열기

    VS Code에서 열기

    VS Code가 설치를 확인하면 Install을 누르세요

  2. VS Code에서 AI 채팅을 Agent 모드로 열기

  3. 해 보기

    Crypto Regime MCP을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ VS Code가 Crypto Regime MCP을 쓰고 있다고 하거나 답에 Crypto Regime MCP 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요

MCP를 쓰는 앱 모두 보기 →

웹으로 연결하는 앱용 주소

주소https://signal-api.shicoars.workers.dev/mcp

JSON 설정은 아래 “개발자용”에 있어요

막혔나요? Crypto Regime MCP을 쓰는 사람에게 물어보세요💬 토론 →
개발자용: 터미널 명령과 JSON 설정

웹으로 연결

Claude Code

claude mcp add --transport http --scope user crypto-regime https://signal-api.shicoars.workers.dev/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "crypto-regime": {
      "url": "https://signal-api.shicoars.workers.dev/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "crypto-regime": {
      "type": "http",
      "url": "https://signal-api.shicoars.workers.dev/mcp"
    }
  }
}

컴퓨터에 설치

Claude Code

claude mcp add --scope user crypto-regime --env EVM_PRIVATE_KEY=your-value -- npx -y @shicodiez/crypto-regime-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "crypto-regime": {
      "command": "npx",
      "args": [
        "-y",
        "@shicodiez/crypto-regime-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "crypto-regime": {
      "command": "npx",
      "args": [
        "-y",
        "@shicodiez/crypto-regime-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "crypto-regime": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@shicodiez/crypto-regime-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "your-value"
      }
    }
  }
}

직접 입력할 값

  • SIGNAL_API_KEY 비밀 env
    POST /credits/buy/starter 또는 /credits/buy/pro에서 반환되는 선불 크레딧 키(sk_...). 설정하면 유료 도구는 X-API-Key와 함께 /v1/를 호출하며 x402 서명은 사용하지 않습니다.
    영어 원문 보기Prepaid credit key (sk_...) returned by POST /credits/buy/starter or /credits/buy/pro. When set, paid tools call /v1/* with X-API-Key and no x402 signing is used.
  • EVM_PRIVATE_KEY 비밀 필수 env
    SIGNAL_API_KEY가 설정되지 않은 경우 x402 결제에 서명하는 데 사용되는 EVM 개인 키. 잔액이 적은 전용 지갑을 사용하십시오.
    영어 원문 보기EVM private key used to sign x402 payments when SIGNAL_API_KEY is not set. Use a dedicated low-balance wallet.
  • MAX_SPEND_USDC env
    x402 모드에서 브리지가 세션당 사용할 수 있는 최대 USDC. 기본값은 1.
    영어 원문 보기Maximum USDC the bridge may spend per session in x402 mode. Defaults to 1.
  • SIGNAL_API_URL env
    크레딧 모드에서 사용되는 REST 기본 URL. 기본값은 MCP URL의 origin입니다.
    영어 원문 보기REST base URL used in credit mode. Defaults to the origin of the MCP URL.

설명은 자동 번역이며 변수 이름은 원문 그대로입니다. 확실하지 않으면 원문을 확인하세요.

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

한눈에 보기

주간 다운로드i
npm/PyPI에 없음
연결 방식
컴퓨터 또는 클라우드
전송 방식
stdio, streamable-http
최신 버전i
0.1.4
레지스트리 공개i
2026년 11월 10일
코드 마지막 변경i
2026년 11월 10일
마지막 확인
2026년 11월 15일
제작자
Shicodiez
패키지
npm: @shicodiez/crypto-regime-mcp
레지스트리 상태
활성

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.

인터넷으로 연결하는 앱

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

내 컴퓨터에서 실행하는 앱

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

모든 앱과 장단점 →

할 수 있는 일

도구 이름과 설명은 서버가 2026년 11월 15일에 알려 준 그대로예요. 우리가 아니라 제작자가 쓴 글이고, 일반 텍스트로만 보여 드려요.

  • list_assets

    List supported crypto assets and product ids for signal-api. Use this first to discover valid `asset` values for get_trend/get_regime and to see prices. Free.

  • get_catalog

    Return the full signal-api catalog: active products, types, params, prices and descriptions. Use when you need the complete product list or metadata. Free.

  • get_sample

    Get a free sample of the last completed daily trend and regime for BTC or ETH. The sample is delayed by one day: today's live data and the other assets are paid. Free, limited to 60 calls/hour per IP.

  • get_signal

    Get the combined daily trend signal for the default basket (BTC + ETH): signal (LONG/FLAT), exposure, SMA50, 30-day volatility, close and dates. Use when you need the overall market stance. Paid: $0.01 USDC per call via x402.

  • get_market_scan

    One call to see what is strong/weak now: every catalog asset with trend, regime, RSI14, 7d/30d returns and distance to the 30d high/low, plus top-5 most bullish/bearish, RSI overbought/oversold and regime counts. Paid: $0.05 USDC per call via x402.

  • get_trend

    Get the daily trend signal for one crypto asset: signal (LONG/FLAT), exposure, SMA50, 30-day volatility, close and dates. Use when you need a directional/exposure view for a specific asset. Paid: $0.005 USDC per call via x402. Discover valid assets with list_assets.

  • get_regime

    Get the market regime for one crypto asset: trend (bullish/bearish/lateral), volatility (low/medium/high/unknown), SMA50 slope, 30-day volatility, close and dates. Use when you need a regime/volatility classification rather than a trade signal. Paid: $0.005 USDC per call via x402

  • get_indicators

    Get calculated daily indicators for one crypto asset: RSI14, MACD(12,26,9), ATR14 absolute and percent, Bollinger(20,2) with %B, returns 7d/30d, 30d/90d highs and lows, and the price distance to each level. Returns only calculated values, never raw candles. Use when you need tech

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 19일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 GitHub 계정 Shicodiez 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

  • ✓ 통과

    계속 관리되고 있음

    코드 마지막 변경: 9일 전

  • ✓ 통과

    라이선스 있음

    MIT 사용

  • ✓ 통과

    엔드포인트 응답

    427ms 만에 응답(HTTP 200)

  • – 해당 없음

    OAuth로 로그인

    로그인 필요 없음

  • ✓ 통과

    도구 설명에 숨겨진 지시 없음

    도구 설명 8개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요

공개된 취약점 (OSV.dev)

OSV.dev에 @shicodiez/crypto-regime-mcp@0.1.4 항목이 없습니다

이 버전의 패키지 자체만 확인하며 모든 의존성은 아닙니다 · 확인 2026년 11월 15일

우리가 확인하는 것 → · JSON

제작자: 재확인 요청 또는 잘못된 정보 신고
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/shicodiez-crypto-regime-mcp.svg)](https://mcp.popnx.com/en/servers/shicodiez-crypto-regime-mcp)

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

사용자 리뷰

아직 리뷰가 없어요

로그인하고 리뷰 쓰기

암호화폐 및 블록체인 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 1759개 중 84%보다 스타가 많아요
  • 이 카테고리의 다른 서버 1759개 중 83%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 1759개 중 99%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Crypto Regime MCP, 안전한가요?

해당하는 기본 점검 5개 중 5개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: EVM_PRIVATE_KEY

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

둘 다 가능해요. 내 컴퓨터에 설치해도 되고, 클라우드 버전에 연결해도 돼요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 9일 전 변경됐고, 최신 버전(0.1.4)은 9일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되므로 원격 MCP를 받는 앱에서도 쓸 수 있어요. 예: 웹 ChatGPT(Business 이상은 전체 MCP, Pro는 읽기 전용).

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: DexSQL, PayRam, DexPaprika, Alchemy MCP Server, X402 List MCP

비슷하게 동작하는 다른 것

같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

DexSQL

SQL for Android APK and DEX files: classes, methods, strings, references and smali.

제작자: LSPosed성장 중★ 32032일 전 업데이트

내 컴퓨터에서 실행✓ lsposed.org

PayRam

Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.

제작자: PayRam성장 중★ 15843일 전 업데이트

클라우드에서 실행✓ 서비스 회사 · payram.com

DexPaprika

DEX and on-chain data: liquidity pools, token prices, swaps, and trading volume.

제작자: coinpaprika성장 중★ 1206일 전 업데이트

클라우드에서 실행✓ 서비스 회사 · dexpaprika.com

X402 List MCP

Find and vet x402 payment APIs before your agent pays one: uptime, price, on-chain volume.

제작자: mcccsm초기↓ 80/주★ 1840일 전 업데이트

컴퓨터 또는 클라우드✓ 서비스 회사 · x402-list.com
비슷한 항목과 비교
이 항목
Crypto Regime MCP
DexSQLPayRamDexPaprikaAlchemy MCP ServerX402 List MCP
실행 위치클라우드 또는 컴퓨터 설치 모두 가능컴퓨터에 설치 필요클라우드에서 동작, 설치 불필요클라우드에서 동작, 설치 불필요클라우드에서 동작, 설치 불필요클라우드 또는 컴퓨터 설치 모두 가능
키 필요예아니요아니요아니요아니요아니요
Claude에서 +로 추가아니요아니요아니요아니요아니요아니요
기본 점검5/52/33/44/44/45/5
라이선스MITNOASSERTION–MITMITMIT
가격등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

Crypto Regime MCP

A stdio MCP bridge for signal-api. It connects Claude Desktop, Claude Code, Cursor or any stdio MCP client to the remote Streamable HTTP MCP endpoint and pays for tools in one of two ways:

  • x402: signs USDC payments on Base with a local EVM wallet.
  • Prepaid credits: sends an X-API-Key to the REST /v1/* routes.

Not Signal Messenger. signal-api is a crypto market-signal service. This

package has no relationship with Signal Messenger or its messaging app.

What it does

  • Speaks MCP over stdio to your client.
  • Connects to https://signal-api.shicoars.workers.dev/mcp using Streamable HTTP.
  • Exposes the remote tools locally, including their input schemas.
  • With SIGNAL_API_KEY, serves paid tools through /v1/* using prepaid credits and adds get_credit_balance.
  • Without SIGNAL_API_KEY, detects x402 PaymentRequired responses and signs USDC payments on Base automatically.
  • Enforces a per-session spending limit with MAX_SPEND_USDC in x402 mode.

The bridge is useful for clients that only support stdio MCP and do not have native x402 payment support. Clients with native x402 support can connect directly to the remote URL.

Payment methods

1. Prepaid credits (SIGNAL_API_KEY)

Set SIGNAL_API_KEY to a credit key (sk_...) bought from signal-api. The bridge then:

  • Calls /v1/signal, /v1/market-scan, /v1/trend/{asset}, /v1/regime/{asset} and /v1/indicators/{asset} with the X-API-Key header.
  • Does not sign x402 payments and does not need EVM_PRIVATE_KEY.
  • Uses the free /free/{asset} route for get_sample.
  • Exposes get_credit_balance, which reads GET /credits/balance.
  • Reports the credits charged and remaining balance in _meta under signal-api/credits when the API returns those headers.

SIGNAL_API_KEY takes precedence when both variables are set.

2. x402 (EVM_PRIVATE_KEY)

Without SIGNAL_API_KEY, the bridge works as before: it connects to the remote MCP endpoint, receives x402 PaymentRequired results, signs USDC payments on Base with EVM_PRIVATE_KEY, and retries the call. MAX_SPEND_USDC caps the amount the bridge may authorize per session.

Tools and prices

Toolx402 priceCreditsDescription
list_assetsFreeFreeList supported assets, product ids and prices. Call this first.
get_catalogFreeFreeFull product catalog with parameters, prices and descriptions.
get_sampleFreeFree1-day-delayed BTC/ETH trend and regime sample. 60 calls/hour per IP.
get_credit_balancen/aFreeRemaining credits for the configured SIGNAL_API_KEY. Credit mode only.
get_signal0.01 USDC1Combined BTC + ETH daily trend signal.
get_market_scan0.05 USDC10All catalog assets plus bullish/bearish, RSI and regime rankings.
get_trend0.005 USDC1Daily LONG/FLAT trend signal and exposure for one asset.
get_regime0.005 USDC1Bullish/bearish/lateral regime and volatility for one asset.
get_indicators0.005 USDC1RSI14, MACD, ATR14, Bollinger %B, returns and 30d/90d ranges.

Network for x402: Base mainnet (eip155:8453), paid in USDC.

Credits are charged per request: get_market_scan costs 10 credits and the other paid tools cost 1 credit. Insufficient credits return HTTP 402 with the current balance; an invalid key returns HTTP 401.

Requirements

  • Node.js 20 or newer
  • Either a credit key from signal-api, or an EVM wallet private key with a small USDC balance on Base
  • An MCP client that supports stdio servers (Claude Desktop, Claude Code, Cursor, or another MCP-compatible client)

Installation

Run the published package with npx:

npx -y @shicodiez/crypto-regime-mcp

Or install it globally:

npm install -g @shicodiez/crypto-regime-mcp

From source:

git clone https://github.com/Shicodiez/crypto-regime-mcp.git

cd crypto-regime-mcp npm install

Run the bridge in credit mode:

SIGNAL_API_KEY=sk_... node src/index.js

Or in x402 mode:

EVM_PRIVATE_KEY=0x... MAX_SPEND_USDC=1 node src/index.js

On Windows PowerShell:

$env:SIGNAL_API_KEY = "sk_..."

node src/index.js

$env:EVM_PRIVATE_KEY = "0x..."

$env:MAX_SPEND_USDC = "1" node src/index.js

The process communicates over stdio. Diagnostics are written to stderr.

Buying a credit pack

Buy a pack with x402. The starter pack costs 5 USDC and returns 2,000 credits; the pro pack costs 20 USDC and returns 10,000 credits.

POST https://signal-api.shicoars.workers.dev/credits/buy/starter

The first request without payment returns HTTP 402 with the x402 requirements in the PAYMENT-REQUIRED header. Sign the USDC payment on Base with any x402-capable client and retry the same request with the signed payload:

curl -i -X POST https://signal-api.shicoars.workers.dev/credits/buy/starter \

-H "PAYMENT-SIGNATURE: "

A successful response looks like:

{

"key": "sk_...", "key_type": "api_key", "pack": "starter", "credits": 2000, "balance": 2000, "payer": "0x...", "transaction": "0x...", "note": "Store this key now. It is not stored and cannot be recovered." }

Store the key immediately: signal-api stores only its SHA-256 hash and cannot show it again. Then set SIGNAL_API_KEY=sk_... in your MCP client and check the balance at any time:

curl https://signal-api.shicoars.workers.dev/credits/balance \

-H "X-API-Key: sk_..."

The same header also works directly on /signal, /p/{id} and /v1/*.

Configuration

VariableRequiredDefaultDescription
SIGNAL_API_KEYOne of these two-Prepaid credit key (sk_...). Enables credit mode and get_credit_balance.
EVM_PRIVATE_KEYOne of these two-32-byte hex private key (0x...) used to sign x402 payments. Ignored when SIGNAL_API_KEY is set.
MAX_SPEND_USDCNo1Maximum USDC the bridge may authorize per session in x402 mode. Set 0 to block paid tools.
SIGNAL_API_MCP_URLNohttps://signal-api.shicoars.workers.dev/mcpRemote MCP endpoint.
SIGNAL_API_URLNoorigin of the MCP URLREST base URL used in credit mode.
NETWORKNoeip155:8453x402 network. Base mainnet is the default.

Claude Desktop

Edit the Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Credit mode:

{

"mcpServers": { "crypto-regime": { "command": "npx", "args": ["-y", "@shicodiez/crypto-regime-mcp"], "env": { "SIGNAL_API_KEY": "sk_..." } } } }

x402 mode: replace SIGNAL_API_KEY with EVM_PRIVATE_KEY and optionally MAX_SPEND_USDC.

Restart Claude Desktop after saving the file.

Claude Code

Credit mode:

claude mcp add crypto-regime \

--env SIGNAL_API_KEY=sk_... \ -- npx -y @shicodiez/crypto-regime-mcp

x402 mode:

claude mcp add crypto-regime \

--env EVM_PRIVATE_KEY=0x... \ --env MAX_SPEND_USDC=1 \ -- npx -y @shicodiez/crypto-regime-mcp

If your Claude Code version supports remote MCP with x402 payments, you can add the hosted endpoint directly instead:

claude mcp add --transport http crypto-regime \

https://signal-api.shicoars.workers.dev/mcp

For credit mode or automatic x402 payments, use the stdio bridge above.

Cursor

Add the server to ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project. Credit mode:

{

"mcpServers": { "crypto-regime": { "command": "npx", "args": ["-y", "@shicodiez/crypto-regime-mcp"], "env": { "SIGNAL_API_KEY": "sk_..." } } } }

x402 mode: replace SIGNAL_API_KEY with EVM_PRIVATE_KEY and optionally MAX_SPEND_USDC.

Reload Cursor after saving the file.

Remote URL

The hosted MCP server is:

https://signal-api.shicoars.workers.dev/mcp

Transport: Streamable HTTP.

  • Free tools work without authentication or payment.
  • Paid MCP tools return an x402 PaymentRequired result.
  • An x402-capable client can pay directly.
  • Clients without native x402 support can use this stdio bridge in x402 mode.
  • Credit keys can also call the REST routes directly with X-API-Key.

Security

  • Use a dedicated wallet in x402 mode. Do not use a wallet that holds savings or other assets. Fund it with only the amount you are willing to spend.
  • Set `MAX_SPEND_USDC` in x402 mode. The default is 1 USDC per session. The bridge refuses payments that would exceed the limit.
  • Protect `SIGNAL_API_KEY`. Treat it like cash: anyone with the key can spend its credits. Do not commit it to a repository.
  • The private key and credit key are stored in plain text in your MCP client configuration. Protect that file and never commit it.
  • Never commit `.env` files or keys. The included .gitignore excludes common local secret files.
  • Review payments. In x402 mode the bridge logs authorized amounts and recipients to stderr. Check the wallet balance and transaction history regularly.
  • The bridge only sends EVM_PRIVATE_KEY to the local signing library; it is never sent to signal-api. SIGNAL_API_KEY is sent only to signal-api.

Development

Run the tests:

npm test

Build (syntax-check the published sources):

npm run build

The test suite covers the session spending tracker, USDC amount conversion, credit-mode route mapping, credit error handling and configuration precedence.

License

MIT. See LICENSE.