TroyStack MCP server
Commit Nov 12, 2026Provides live precious metals data, portfolio management, and market intelligence for AI-driven financial analysis.
Also known as kingleosgold/troystack-api, troystack-api
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 3.0.2
- Last commit
- Nov 12, 2026
- License
- —
What is TroyStack MCP?
TroyStack provides live precious metals data, portfolio management, and market intelligence for AI-driven financial analysis.
Summary generated from the project's README
About TroyStack MCP server
TroyStack serves as a specialized interface for accessing precious metals data and managing investment portfolios through an MCP server. It provides real-time spot prices for gold, silver, platinum, and palladium, alongside historical price data and COMEX inventory tracking. Developers can use this server to integrate market intelligence, such as news headlines and speculation projections, directly into AI-driven financial workflows.
To use this server, you must configure it with Supabase credentials, including a URL and service role key. The system supports both public data access and authenticated requests via Bearer tokens for sensitive operations. Once set up, it allows AI agents to interact with private portfolio summaries, cost basis analytics, and specific holdings. The architecture is designed to sync data between local mobile storage and a centralized Supabase backend hosted on Railway.
What you can do with it
- 1Monitor live metal pricesAsk the AI to retrieve current spot prices for gold, silver, platinum, or palladium.
- 2Analyze personal metal holdingsRequest a summary of your current portfolio and cost basis analysis using an authentication token.
- 3Track market trends and newsInstruct an agent to fetch recent news headlines and COMEX inventory levels to gauge market sentiment.
- 4Perform speculative financial modelingUse the speculation endpoint to run what-if projections for precious metals.
Written from the project's README. Every use case is checked against a quote from it.
How to install TroyStack MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall TroyStack MCP in Claude Code
$ claude mcp add --transport http troystack-api https://api.troystack.ai/mcpInstall TroyStack MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"troystack-api": {
"url": "https://api.troystack.ai/mcp"
}
}
}Install TroyStack MCP in VS Code
.vscode/mcp.json
{
"servers": {
"troystack-api": {
"type": "http",
"url": "https://api.troystack.ai/mcp"
}
}
}Install TroyStack MCP in VS Code CLI
$ code --add-mcp '{"name":"troystack-api","type":"http","url":"https://api.troystack.ai/mcp"}'Install TroyStack MCP in Codex
$ codex mcp add troystack-api --url https://api.troystack.ai/mcpInstall TroyStack MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.troystack-api] url = "https://api.troystack.ai/mcp"
Install TroyStack MCP in Gemini CLI
$ gemini mcp add -s user --transport http troystack-api https://api.troystack.ai/mcpInstall TroyStack MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"troystack-api": {
"url": "https://api.troystack.ai/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablekingleosgold/troystack-api is public and reachablegithub.com/kingleosgold/troystack-api ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-12github.com/kingleosgold/troystack-api ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 284 msPass
README
View on GitHubTroyStack 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)
TroyStack MCP questions
How do I add TroyStack MCP to Claude Code?
Run claude mcp add --transport http troystack-api https://api.troystack.ai/mcp in your terminal. Add --scope user to make it available in every project.
How do I add TroyStack MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What precious metals data is available?
The server provides live spot prices for Gold (Au), Silver (Ag), Platinum (Pt), and Palladium (Pd).
How can I access portfolio management features?
Portfolio features like summaries, cost basis analysis, and holdings management require Bearer token authentication.
Does the server provide market news?
Yes, you can access market intelligence through news headlines.