HTMW MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
HTMW MCP
Connect your HowTheMarketWorks simulator account to an AI assistant through the Model Context Protocol.
Read your portfolio, look up quotes, search symbols, inspect orders and transaction history, and check contest rankings. You can also place or cancel a simulated order after explicitly requesting it. The server provides nine tools over stdio or authenticated HTTP.
Your MCP client → HTMW MCP → Your HowTheMarketWorks accountRun locally
You need Node.js 22 or newer, npm, and an HTMW account with an active contest.
git clone https://github.com/jerryj6/htmw-mcp.git
cd htmw-mcp
npm ci --ignore-scripts
npm run buildAdd this to an MCP client's mcpServers configuration, replacing the path and credentials:
{
"mcpServers": {
"htmw": {
"command": "node",
"args": ["/absolute/path/to/htmw-mcp/dist/index.js"],
"env": {
"HTMW_USERNAME": "your_username",
"HTMW_PASSWORD": "your_password"
}
}
}
}Restart the client and ask: “Show my HTMW portfolio.” See the copyable stdio configuration. Configuration location varies by client; it must support MCP servers over stdio. On Windows, use an absolute path such as C:/Users/you/htmw-mcp/dist/index.js.
For terminal use, copy .env.example to .env, fill in your credentials, and run npm start. This starts a stdio protocol server that waits for an MCP client; it is not an interactive terminal prompt. Login happens on the first account request.
Related MCP server: FinanceKit MCP
Deploy your own server
Click the button, supply your HTMW username and password, and deploy. Render generates an MCP_AUTH_TOKEN; copy it from your service's environment settings. Connect your MCP client with:
Setting | Value |
Transport | Streamable HTTP |
URL |
|
Header |
|
Your client must support custom authorization headers. Each deployment connects to one HTMW account; anyone holding its token can use that account's tools. This repository contains source code for your own instance, not a shared account endpoint.
Prefer self-hosting? Use Docker Compose, or follow the HTTP and Render guide. No database is required. Render instances created with the button use manual deploys so you can choose when to update them.
Available tools
Tool | Purpose |
| Balances, positions, and open orders |
| Quote for a stock symbol |
| Find symbols by company name or ticker |
| Pending orders and their IDs |
| Transactions over a chosen lookback |
| Contests available to the account |
| Top five, bottom five, and your rank when identifiable |
| Place a requested simulated order; requires |
| Cancel a requested order; requires |
See tool inputs, examples, and account behavior. Orders and portfolio data use the account currently selected on HTMW. Starting the server runs no trading strategy or background scans.
Troubleshooting
Missing credentials: pass
HTMW_USERNAMEandHTMW_PASSWORDin the client configuration, or place them in.envin the server's working directory.HTTP 401: send your deployment's bearer token on each MCP request.
HTTP 403: configure your browser client's exact origin in
MCP_ALLOWED_ORIGINS.Cold start: an idle free Render instance may take time to wake up. Check
https://YOUR-SERVICE.onrender.com/health, then reconnect.Login or parsing errors: verify your account directly on HTMW. The integration uses website endpoints, so upstream changes may need parser updates. See the deployment guide.
Develop and contribute
npm ci --ignore-scripts
npm run checkChecks cover formatting, TypeScript, and mocked regression and transport tests. They do not access an HTMW account or place simulator orders. See development, contributing, and release notes.
License
MIT. Unofficial integration; not affiliated with HowTheMarketWorks.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Live stock quotes, a stock screener, crypto prices and FX rates as agent tools.
Agentic brokerage access to a US brokerage account: quotes, orders, positions, cash and documents.
Unified financial infrastructure connecting AI agents directly to trade live/demo brokerage accounts, Web3 non-custodial wallets, real-time market data across equities, ETFs, crypto, forex, options, DeFi swaps, and prediction markets, institutional research feeds, and algorithmic strategy backtesters.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables trading and portfolio management through the Alpaca API, allowing users to place orders, manage positions and watchlists, access market data, and retrieve account information through natural language.22 npm4ISC
- AlicenseAqualityDmaintenanceProvides AI agents with real-time financial market intelligence including stock quotes, crypto data, technical analysis, and portfolio insights. Enables natural language queries for current prices, technical indicators, asset comparisons, and portfolio analysis.1710MIT
- AlicenseAqualityDmaintenanceEnables AI agents to trade on Interactive Brokers: check quotes, balance, positions, and execute buy/sell orders (including fractional shares by dollar amount) via the Client Portal API.2015MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to interact with the Tradewink trading platform, including real-time market data, portfolio management, order execution, and AI-driven analysis via the Model Context Protocol.29 npmMIT