io.github.kingleosgold/troystack

Official12 tools

by kingleosgold · JavaScript

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

Analyze precious metals with tools for pricing, portfolios, and transaction tracking.

Captured live from the server via tools/list.

get_spot_prices

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

No parameters.

get_price_history

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

Parameters (2)

metalstringrequired
The metal to fetch history for
rangestring
Time range (default 1Y)

get_stack_signal

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

Parameters (3)

limitinteger
Max articles to return (default 20)
offsetinteger
Pagination offset (default 0)
categorystring
Optional category filter

get_vault_watch

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

Parameters (1)

metalstring
Optional metal filter; returns all 4 if omitted

get_junk_silver

Calculates silver melt value for pre-1965 US coinage

Parameters (6)

dimesinteger
Roosevelt/Mercury dime count (0.07234 oz Ag each)
quartersinteger
Washington quarter count (0.18084 oz Ag each)
half_dollarsinteger
Walking Liberty/Franklin/1964 Kennedy half count (0.36169 oz Ag each)
kennedy_40integer
Kennedy 1965-1970 40% silver halves (0.14792 oz Ag each)
dollarsinteger
Morgan/Peace dollar count (0.77344 oz Ag each)
war_nickelsinteger
Jefferson 1942-1945 war nickel count (0.05626 oz Ag each)

get_speculation

Calculates price multipliers comparing current spot to hypothetical target prices

Parameters (4)

goldnumber
Target gold price per oz
silvernumber
Target silver price per oz
platinumnumber
Target platinum price per oz
palladiumnumber
Target palladium price per oz

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.

Parameters (2)

messagestringrequired
Your question or message for Troy
api_keystring
TroyStack API key for portfolio-aware responses (optional)

get_portfolio

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

Parameters (1)

api_keystringrequired
TroyStack API key (required)

add_holding

Add a precious metals purchase to your portfolio

Parameters (7)

api_keystringrequired
TroyStack API key (required)
metalstringrequired
Metal type
typestring
Product name (e.g. "2024 American Silver Eagle")
quantityintegerrequired
Number of pieces
weight_oznumberrequired
Weight per piece in troy ounces
purchase_pricenumberrequired
Price per piece in USD
purchase_datestring
Purchase date YYYY-MM-DD (default: today)

get_analytics

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

Parameters (1)

api_keystringrequired
TroyStack API key (required)

scan_receipt

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

Parameters (2)

api_keystringrequired
TroyStack API key (required)
image_base64stringrequired
Base64-encoded receipt image (JPEG)

get_daily_brief

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

Parameters (1)

api_keystring
TroyStack API key for personalized brief (optional)

README.md2 KBView on GitHub

TroyStack API

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

Quick Start

bash

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

Deploy to Railway

Push to GitHub repo
Connect repo in Railway dashboard
Set environment variables:
- SUPABASE_URL
- SUPABASE_SERVICE_ROLE_KEY
- PORT (Railway sets automatically)
Deploy

Custom domain: api.troystack.ai

Database Setup

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

Endpoints

Public (no auth)

Method	Path	Description
GET	`/v1/prices`	Live spot prices (Au, Ag, Pt, Pd)
GET	`/v1/prices/history`	Historical prices
GET	`/v1/market-intel`	News headlines
GET	`/v1/vault-watch`	COMEX inventory
GET	`/v1/speculation`	What-if projections

Authenticated (Bearer token)

Method	Path	Description
GET	`/v1/portfolio`	Portfolio summary
GET	`/v1/analytics`	Cost basis analysis
GET	`/v1/holdings`	List holdings
POST	`/v1/holdings`	Add purchase

LLM / AI

Path	Description
`/llms.txt`	LLM-readable description
`/openapi.json`	OpenAPI 3.0 spec
`/.well-known/ai-plugin.json`	AI plugin manifest
`/.well-known/mcp.json`	MCP server manifest

Architecture

code

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

Install

claude_desktop_config.json

{
  "mcpServers": {
    "troystack": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.troystack.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.