Troystack

kingleosgold/troystack-api

Connects Claude to TroyStack's precious metals platform with 12 tools covering live spot prices for gold, silver, platinum, and palladium, portfolio management with cost basis analytics, market news headlines, COMEX vault inventory tracking, and what-if price projections. Authenticated routes let you sync holdings from the mobile app's SQLite database through Supabase, add new purchases, and pull portfolio summaries. Useful if you're building AI workflows around metals trading analysis or want Claude to answer questions about your stack's performance without manually copying data. The API runs on Railway at api.troystack.ai and exposes both public market data endpoints and private portfolio operations via Bearer token auth.

tools: 12
transport: HTTP
last updated: Apr 12, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://api.troystack.ai/mcp --name troystack

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http troystack https://api.troystack.ai/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 12 tools

Verified live against the running server on Nov 6, 2026.

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

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

No parameters. Call it with no arguments.

get_price_historyHistorical spot price data for a precious metal over a time range2 params

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

Parameters* required

metal*string

The metal to fetch history forone of gold · silver · platinum · palladium

rangestring

Time range (default 1Y)one of 1M · 3M · 6M · 1Y · 5Y · ALL

get_stack_signalReturns Stack Signal — TroyStack's curated precious metals market intelligence with Troy's commentary3 params

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

Parameters* required

categorystring

Optional category filter

limitinteger

Max articles to return (default 20)

offsetinteger

Pagination offset (default 0)

get_vault_watchReturns COMEX warehouse inventory: registered, eligible, combined ounces, daily changes, open interest, oversubscribed ratio1 params

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

Parameters* required

metalstring

Optional metal filter; returns all 4 if omittedone of gold · silver · platinum · palladium

get_junk_silverCalculates silver melt value for pre-1965 US coinage6 params

Calculates silver melt value for pre-1965 US coinage

Parameters* required

dimesinteger

Roosevelt/Mercury dime count (0.07234 oz Ag each)

dollarsinteger

Morgan/Peace dollar count (0.77344 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)

quartersinteger

Washington quarter count (0.18084 oz Ag each)

war_nickelsinteger

Jefferson 1942-1945 war nickel count (0.05626 oz Ag each)

get_speculationCalculates price multipliers comparing current spot to hypothetical target prices4 params

Calculates price multipliers comparing current spot to hypothetical target prices

Parameters* required

goldnumber

Target gold price per oz

palladiumnumber

Target palladium price per oz

platinumnumber

Target platinum price per oz

silvernumber

Target silver price per oz

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

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

Parameters* required

api_keystring

TroyStack API key for portfolio-aware responses (optional)

message*string

Your question or message for Troy

get_portfolioReturns your precious metals portfolio: total value, cost basis, gain/loss, per-metal breakdown, and individual holdings1 params

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

Parameters* required

api_key*string

TroyStack API key (required)

add_holdingAdd a precious metals purchase to your portfolio7 params

Add a precious metals purchase to your portfolio

Parameters* required

api_key*string

TroyStack API key (required)

metal*string

Metal typeone of gold · silver · platinum · palladium

purchase_datestring

Purchase date YYYY-MM-DD (default: today)

purchase_price*number

Price per piece in USD

quantity*integer

Number of pieces

typestring

Product name (e.g. "2024 American Silver Eagle")

weight_oz*number

Weight per piece in troy ounces

get_analyticsCost basis, average cost per oz, break-even price, unrealized P/L per metal1 params

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

Parameters* required

api_key*string

TroyStack API key (required)

scan_receiptExtract precious metals purchase data from a receipt image using AI vision2 params

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

Parameters* required

api_key*string

TroyStack API key (required)

image_base64*string

Base64-encoded receipt image (JPEG)

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

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

Parameters* required

api_keystring

TroyStack API key for personalized brief (optional)

Readme

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

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

View the full README on GitHub

Details

Repository: github.com/kingleosgold/troystack-api
Category: Communication & Messaging
Transport: HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Communication & Messaging MCP servers

View all

Hostawaymattlong-plux/hostaway-mcpHostaway PMS: reservations, listings, calendars, financials, and guest messaging.0stars

TubePullmiketwalker/tubepull-mcpAI YouTube downloader: save YouTube, TikTok, Instagram + 10 more as MP4/MP3 from any AI chat.0stars

AgentCanarymrcerq/agentcanary-mcpRetired compatibility stub for AgentCanary MCP. Daily briefs continue on X and Telegram.0stars

Bionic Formsio.github.mwbidwell/bionicforms-mcpRead, search and add records in your Bionic Forms apps (hosted database apps for small teams).0stars

MyRouteOnlineio.github.myrouteonline/myrouteonlineMulti-stop route optimization, navigation links, and email delivery. Powered by MyRouteOnline.0stars

Image Vieweroguntolaibrahim/inchat-image-viewer-mcpInChat Image Viewer MCP - View images inline in AI chat by just providing the file path0stars