About Troystack
TroyStack’s REST API and MCP server provide precious-metals prices, COMEX inventory, market news, and portfolio management. It is intended for applications and agents working with metals data and holdings.
Key features
- 01Live and historical precious-metals prices
- 02COMEX inventory and market news
- 03Portfolio and cost-basis analysis
- 04OpenAPI and MCP manifests
Use cases
- 01Check Au, Ag, Pt, and Pd prices and history
- 02Review COMEX inventory and market headlines
- 03Manage holdings and analyze cost basis
MCP support
It provides an MCP server manifest for MCP clients to discover the service; the README does not list specific MCP tools or resources.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.troystack.ai/mcpclaude mcp add --transport http troystack-api https://api.troystack.ai/mcp{"mcpServers":{"troystack-api":{"type":"http","url":"https://api.troystack.ai/mcp"}}}Open in Cursor{"servers":{"troystack-api":{"type":"http","url":"https://api.troystack.ai/mcp"}}}Open in VS Code{"mcpServers":{"troystack-api":{"type":"http","url":"https://api.troystack.ai/mcp"}}}{"mcpServers":{"troystack-api":{"serverUrl":"https://api.troystack.ai/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
12This tool takes no parameters.
Details
From the project READMETroyStack 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_URLSUPABASE_SERVICE_ROLE_KEYPORT(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
User's iPhone → TroyStack app (local SQLite)
↕ sync
Supabase (server-side storage)
↕
TroyStack API (Railway)
↕ ↕
AI Agents X/Twitter Bot
(Claude, GPT) (auto-tweets)
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.