Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Crypto Regime MCP

de Shicodiezversión 0.1.4i★ 1iComputadora o nubeSitio oficial ↗
Nombre en el registroio.github.Shicodiez/crypto-regime-mcp

Cómo instalar

What it does

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

  • Connects Computadora o nube
  • Account or key Cloud: No key needed · Local: Needs EVM_PRIVATE_KEY
  • Category Cripto y blockchain

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad4/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso24/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Crypto Regime MCP. Sigue https://mcp.popnx.com/i/shicodiez-crypto-regime-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (signal-api.shicoars.workers.dev) · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreCrypto Regime MCP
    Remote MCP server URL · Direcciónhttps://signal-api.shicoars.workers.dev/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsCrypto Regime MCP

  4. Pruébalo

    Usa Crypto Regime MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Crypto Regime MCP o muestra una herramienta de Crypto Regime MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreCrypto Regime MCP
    Connection · Direcciónhttps://signal-api.shicoars.workers.dev/mcp
  3. Elige Crypto Regime MCP en un chat

    Abre un chat nuevo y elige Crypto Regime MCP en tus plugins antes de escribir

  4. Pruébalo

    Usa Crypto Regime MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando Crypto Regime MCP o muestra una herramienta de Crypto Regime MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user crypto-regime https://signal-api.shicoars.workers.dev/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver Crypto Regime MCP en la lista como conectado

  4. Pruébalo

    Usa Crypto Regime MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Crypto Regime MCP o muestra una herramienta de Crypto Regime MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa Crypto Regime MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Crypto Regime MCP o muestra una herramienta de Crypto Regime MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa Crypto Regime MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Crypto Regime MCP o muestra una herramienta de Crypto Regime MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://signal-api.shicoars.workers.dev/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Crypto Regime MCP💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

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"
    }
  }
}

Instalado en tu computadora

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"
      }
    }
  }
}

Valores que debes completar

  • SIGNAL_API_KEY secreto env
    Clave de crédito prepagado (sk_...) devuelta por POST /credits/buy/starter o /credits/buy/pro. Si se define, las herramientas de pago llaman a /v1/ con X-API-Key y no se usa firma x402.
    Ver original en inglésPrepaid 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 secreto obligatorio env
    Clave privada EVM utilizada para firmar los pagos x402 cuando SIGNAL_API_KEY no está definida. Use una billetera dedicada con saldo bajo.
    Ver original en inglésEVM private key used to sign x402 payments when SIGNAL_API_KEY is not set. Use a dedicated low-balance wallet.
  • MAX_SPEND_USDC env
    Máximo de USDC que el puente puede gastar por sesión en modo x402. El valor predeterminado es 1.
    Ver original en inglésMaximum USDC the bridge may spend per session in x402 mode. Defaults to 1.
  • SIGNAL_API_URL env
    URL base REST usada en el modo de crédito. Por defecto es el origen de la URL de MCP.
    Ver original en inglésREST base URL used in credit mode. Defaults to the origin of the MCP URL.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.1.4
Publicado en el registroi
10 nov 2026
Último cambio de códigoi
10 nov 2026
Última revisión
15 nov 2026
Creador
Shicodiez
Paquetes
npm: @shicodiez/crypto-regime-mcp
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

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

Se ejecutan en tu computadora en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 15 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • 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

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub Shicodiez, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 9 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 427 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 8 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para @shicodiez/crypto-regime-mcp@0.1.4

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

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

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Cripto y blockchaini

  • Más estrellas que el 84% de los otros 1759 servidores de esta categoría
  • Publicado en el registro más recientemente que el 83% de los otros 1759 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 1759 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Crypto Regime MCP?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: EVM_PRIVATE_KEY

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 9 días, y la última versión (0.1.4) llegó al registro hace 9 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: DexSQL, PayRam, DexPaprika, Alchemy MCP Server, X402 List MCP

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

DexSQL

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

de LSPosedEn crecimiento★ 320Actualizado hace 32 días

Se ejecuta en tu computadora✓ lsposed.org

PayRam

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

de PayRamEn crecimiento★ 158Actualizado hace 43 días

Se ejecuta en la nube✓ del servicio · payram.com

DexPaprika

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

de coinpaprikaEn crecimiento★ 120Actualizado hace 6 días

Se ejecuta en la nube✓ del servicio · dexpaprika.com

Alchemy MCP Server

Blockchain data across 100+ chains: token prices, NFTs, transfers, simulation, traces, Solana DAS

de alchemyplatformEn crecimiento★ 88Actualizado hace 8 días

Se ejecuta en la nube✓ del servicio · alchemy.com

X402 List MCP

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

de mcccsmInicial↓ 80/sem★ 18Actualizado hace 40 días

Computadora o nube✓ del servicio · x402-list.com
Comparado con otros parecidos
Este
Crypto Regime MCP
DexSQLPayRamDexPaprikaAlchemy MCP ServerX402 List MCP
Dónde se ejecutaEn la nube o instalado en tu equipoSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipo
Necesita claveSíNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas5/52/33/44/44/45/5
LicenciaMITNOASSERTION–MITMITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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.