English Français العربية

io.github.kingleosgold/troystack

السجل الرسمي التجارة الإلكترونية

Precious metals AI analyst with 12 tools — prices, portfolio, chat, receipts, and more.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http troystack 'https://api.troystack.ai/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "troystack": {
            "type": "http",
            "url": "https://api.troystack.ai/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. TroyStack API
  2. Quick Start
  3. Deploy to Railway
  4. Database Setup
  5. Endpoints
  6. Architecture

TroyStack API

REST API + MCP Server for TroyStack. Provides live precious metals data, portfolio management, and AI/LLM integration.

Quick Start

npm install
cp .env.example .env  # fill in Supabase credentials
npm run dev

Deploy to Railway

  1. Push to GitHub repo
  2. Connect repo in Railway dashboard
  3. Set environment variables:
    • SUPABASE_URL
    • SUPABASE_SERVICE_ROLE_KEY
    • PORT (Railway sets automatically)
  4. Deploy

Custom domain: api.troystack.ai

Database Setup

Run migrations/001_api_keys.sql in Supabase SQL editor.

Endpoints

Public (no auth)
MethodPathDescription
GET/v1/pricesLive spot prices (Au, Ag, Pt, Pd)
GET/v1/prices/historyHistorical prices
GET/v1/market-intelNews headlines
GET/v1/vault-watchCOMEX inventory
GET/v1/speculationWhat-if projections
Authenticated (Bearer token)
MethodPathDescription
GET/v1/portfolioPortfolio summary
GET/v1/analyticsCost basis analysis
GET/v1/holdingsList holdings
POST/v1/holdingsAdd purchase
LLM / AI
PathDescription
/llms.txtLLM-readable description
/openapi.jsonOpenAPI 3.0 spec
/.well-known/ai-plugin.jsonAI plugin manifest
/.well-known/mcp.jsonMCP server manifest

Architecture

User's iPhone → TroyStack app (local SQLite)
                          ↕ sync
                    Supabase (server-side storage)
                          ↕
                    TroyStack API (Railway)
                      ↕         ↕
                  AI Agents    X/Twitter Bot
                (Claude, GPT)  (auto-tweets)

الأسئلة الشائعة

ما هو io.github.kingleosgold/troystack؟

Precious metals AI analyst with 12 tools — prices, portfolio, chat, receipts, and more.

كيف أثبّت io.github.kingleosgold/troystack؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http troystack 'https://api.troystack.ai/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.kingleosgold/troystack إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.kingleosgold/troystack مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.kingleosgold/troystack؟

ينشره kingleosgold. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.