SignalStack
Daily crypto market score 0-100 across 7 categories, via REST and MCP.
ماذا يمكنك أن تفعل مع SignalStack؟
- 80-100: Strongly Bullish
- 60-79: Bullish
- 40-59: Neutral
- 20-39: Bearish
- 0-19: Strongly Bearish
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport sse signalstack 'https://mcp.sigintstack.io/mcp' --header 'X-SignalStack-Version: <Optional client version hint for SignalStack MCP routing.>'
{
"mcpServers": {
"signalstack": {
"type": "sse",
"url": "https://mcp.sigintstack.io/mcp",
"headers": {
"X-SignalStack-Version": "<Optional client version hint for SignalStack MCP routing.>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
SignalStack
Daily crypto market intelligence — a 0-100 Candle Review score from real on-chain and market data. Available as a REST API and MCP server for AI agents.
What It Does
Every day at ~06:00 UTC, SignalStack pulls live data from DefiLlama, CoinGecko, and Dune Analytics, scores market conditions across 7 categories, and publishes a structured Candle Review.
Categories and weights:
| Category | Max Score |
|---|---|
| Price Action | 25 |
| On-Chain | 20 |
| Derivatives | 20 |
| ETF Flows | 15 |
| Macro | 10 |
| Dominance | 5 |
| Sentiment | 5 |
| Total | 100 |
Score labels:
- 80-100: Strongly Bullish
- 60-79: Bullish
- 40-59: Neutral
- 20-39: Bearish
- 0-19: Strongly Bearish
REST API — Live
Base URL: http://96.126.106.225:3458
OpenAPI spec: GET /openapi.yaml
Endpoints
| Endpoint | Tier | Description |
|---|---|---|
GET /health | Free | Health check |
GET /candle/today | Free + Pro | Today's Candle Review |
GET /candle/history?limit=30 | Free + Pro | Historical reviews |
GET /candle/category/{category} | Pro only | Category breakdown |
GET /openapi.yaml | Free | OpenAPI 3.0 specification |
Freemium Tiers
| Free | Pro | |
|---|---|---|
| API Key | Not required | X-API-Key header |
/candle/today | date, score, label | Full JSON |
/candle/history | date, score, label | Full JSON |
/candle/category/:cat | ❌ 403 | ✅ Full breakdown |
Getting an API Key
Contact the SignalStack team or check the RapidAPI listing for pro tier access. Free tier requires no key.
Example — Free tier
curl http://96.126.106.225:3458/candle/today
{
"date": "2026-03-28",
"score": 67,
"label": "Bullish"
}
Example — Pro tier
curl -H "X-API-Key: your-key-here" http://96.126.106.225:3458/candle/today
{
"date": "2026-03-28",
"score": 67,
"label": "Bullish",
"categories": {
"price_action": { "score": 18, "max": 25, "summary": "BTC up 3.2% on strong volume." },
"on_chain": { "score": 14, "max": 20, "summary": "Exchange reserves declining." },
"derivatives": { "score": 13, "max": 20, "summary": "Funding rates slightly positive." },
"etf_flows": { "score": 11, "max": 15, "summary": "Spot ETF net inflows $400M." },
"macro": { "score": 6, "max": 10, "summary": "DXY weakening, risk-on." },
"dominance": { "score": 3, "max": 5, "summary": "BTC dominance stable at 54%." },
"sentiment": { "score": 2, "max": 5, "summary": "Fear & Greed index at 68." }
},
"outlook": "Near-term momentum remains bullish.",
"what_happened": "Spot ETF inflows hit $400M. BTC held above $70k.",
"generated_at": "2026-03-28T06:00:01.000Z"
}
MCP Server — AI Agent Integration
SignalStack exposes an MCP (Model Context Protocol) server via SSE transport for direct AI agent integration.
Connection
SSE endpoint: GET http://96.126.106.225:3458/mcp
Request endpoint: POST http://96.126.106.225:3458/mcp
Available MCP Tools
| Tool | Tier | Description |
|---|---|---|
candle.get_today | Free + Pro | Today's composite score |
candle.get_history | Free + Pro | Historical reviews |
candle.get_category | Pro | Category breakdown |
Connecting with an MCP client
// Example using MCP SDK
const client = new Client({ name: "my-agent", version: "1.0.0" }, { capabilities: {} });
const transport = new SSEClientTransport(new URL("http://96.126.106.225:3458/mcp"));
await client.connect(transport);
const result = await client.callTool({ name: "candle.get_today", arguments: {} });
Pass X-API-Key as a header on the SSE connection for pro tier access.
OpenAPI Specification
The full OpenAPI 3.0 spec is served live at:
GET http://96.126.106.225:3458/openapi.yaml
Also available as a static file at openapi.yaml in the project root.
Stack
- Runtime: Node.js + TypeScript
- Framework: Express
- Data sources: DefiLlama (free), CoinGecko (free/demo), Dune Analytics
- Storage: SQLite (score store, api-keys.db)
- Transport: REST + MCP SSE
- Deploy: systemd service + nginx reverse proxy
Directory Listings
SignalStack is listed on:
- RapidAPI — REST API discovery
- Smithery — MCP server registry
- mcp.run — MCP server registry
- Futurepedia — AI tools directory
- There's An AI For That — AI tools directory
Versions
| Phase | Status | Description |
|---|---|---|
| P0-P2 | ✅ Complete | MCP tools: DefiLlama + CoinGecko + Dune (21 tools) |
| P3 | ✅ Complete | Candle Review scoring engine |
| P4 | ✅ Complete | REST API + public MCP SSE + freemium gating |
| P5 | ✅ Complete | OpenAPI spec + directory listings |
| P6 | Backlog | Stripe billing integration |
الأسئلة الشائعة
ما هو SignalStack؟
Daily crypto market score 0-100 across 7 categories, via REST and MCP.
كيف أثبّت SignalStack؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport sse signalstack 'https://mcp.sigintstack.io/mcp' --header 'X-SignalStack-Version: <Optional client version hint for SignalStack MCP routing.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج SignalStack إلى مفتاح API؟
نعم. يتطلب X-SignalStack-Version، وتضبطها في إعداداته.
هل SignalStack مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون SignalStack؟
ينشره ud4090v. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.