Troystack

io.github.kingleosgoldPublished by GitHub account kingleosgoldv3.0.2Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server for precious metals: live spot prices, market intelligence, portfolio tracking, and an AI analyst chat.

What you can do
  • Read live spot prices for gold, silver, platinum and palladium, plus historical price series and what-if price multiplier projections
  • Review market intelligence: curated Stack Signal commentary, COMEX vault inventory and open interest, and a daily market brief
  • Ask an AI analyst questions about metals, markets or your own stack, optionally personalized with an API key
  • Track a portfolio: total value, cost basis, gain/loss, per-metal breakdown, analytics and break-even, and add new purchases
  • Calculate silver melt value for pre-1965 US coinage and extract purchase details from a receipt image
When to use it
Useful when you follow precious metals markets and want an assistant to pull spot prices, vault data and commentary, or to keep and analyze a personal bullion portfolio in one place.
Requirements
A remote endpoint at api.troystack.ai over streamable HTTP; no local install or declared environment variables. Portfolio and personalized chat features require an API key supplied to the relevant tools; public price and market data need no authentication.
Before you install
Portfolio tools read your holdings and cost basis, and add_holding writes new purchase records, so treat the API key as sensitive. Receipt scanning sends the uploaded image to the service for AI vision extraction. Market commentary and projections are informational, not investment advice.

Installation

In SourceWeft

  1. Open Troystack in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.kingleosgold%2Ftroystack/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "troystack": {
      "type": "http",
      "url": "https://api.troystack.ai/mcp"
    }
  }
}

README

TroyStack API

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

Quick Start

bash
npm installcp .env.example .env  # fill in Supabase credentialsnpm 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)

Source: README.md at commit a33e928

Tools

12

get_spot_prices

Get Spot Prices

Returns current spot prices for gold, silver, platinum, and palladium with daily change percentages

Takes no parameters.

get_price_history

Get Price History

Historical spot price data for a precious metal over a time range

Parametersmetalrequiredrange

get_stack_signal

Get Stack Signal Articles

Returns Stack Signal — TroyStack's curated precious metals market intelligence with Troy's commentary

Parameterslimitoffsetcategory

get_vault_watch

Get COMEX Vault Watch

Returns COMEX warehouse inventory: registered, eligible, combined ounces, daily changes, open interest, oversubscribed ratio

Parametersmetal

get_junk_silver

Calculate Junk Silver Melt Value

Calculates silver melt value for pre-1965 US coinage

Parametersdimesdollarsquarterskennedy_40war_nickelshalf_dollars

get_speculation

Run What-If Price Scenario

Calculates price multipliers comparing current spot to hypothetical target prices

Parametersgoldsilverplatinumpalladium

chat_with_troy

Chat with Troy

Ask Troy anything about precious metals, markets, your stack. Provide api_key for personalized portfolio-aware answers, or omit for general market analysis.

Parametersapi_keymessagerequired

get_portfolio

Get Portfolio

Returns your precious metals portfolio: total value, cost basis, gain/loss, per-metal breakdown, and individual holdings

Parametersapi_keyrequired

add_holding

Add Holding

Add a precious metals purchase to your portfolio

Parameterstypemetalrequiredapi_keyrequiredquantityrequiredweight_ozrequiredpurchase_datepurchase_pricerequired

get_analytics

Get Portfolio Analytics

Cost basis, average cost per oz, break-even price, unrealized P/L per metal

Parametersapi_keyrequired

scan_receipt

Scan Receipt

Extract precious metals purchase data from a receipt image using AI vision

Parametersapi_keyrequiredimage_base64required

get_daily_brief

Get Daily Brief

Troy's daily market brief. Provide api_key for personalized brief, or omit for the latest Stack Signal market synthesis.

Parametersapi_key

Version history

1
  1. v3.0.2LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.