Stock Trends Market Intelligence MCP server

Stock Trends MCP Server

Local Model Context Protocol (MCP) adapter for public Stock Trends API resources.

Architecture Boundary (What This Server Is)

This repository is a thin local stdio adapter over the front-facing Stock Trends API. It has no independent analytical authority of its own.

Authority flows in one direction only:

Stock Trends dataset
  -> Stock Trends API
  -> published Stock Trends API responses/artifacts
  -> MCP adapter (this repository)
  -> external MCP clients/agents

The MCP adapter:

• Does not recompute Stock Trends data, ST-IM, or indicators.
• Does not access the Stock Trends database or control plane directly.
• Does not generate investment advice, research, or trading guidance.
• Only translates reviewed, published Stock Trends API responses into MCP resource and tool responses.

Public resources and the default/free mode described below are credential-free: no API key, subscription, or payment credential is required to install, inspect, or use them. The conditional paid ST-IM execution path is a separate, explicitly gated surface that is disabled by default (see Conditional Paid ST-IM Tools). An additional default-off x402 posture can expose the same paid semantic tool names. Relay plus challenge flags preserve the local mock-only behavior; a distinct third live flag may enable a capped, one-request no-key challenge path. Neither x402 mode accepts or forwards proof, sends a payment header, returns paid data, pays, or spends.

New here? Start with the Default / Free Mode Quickstart below to install and run the server credential-free, then Connect a local stdio MCP client to wire it into an MCP client, and read Paid Mode Configuration and the Security Model before setting any paid variable.

Default / Free Mode Quickstart

This is the recommended first path for installing or inspecting the server. In default mode, the server:

• Requires no API key.
• Performs no paid execution and creates no spend.
• Exposes exactly one MCP tool: stocktrendsestimateworkflow_cost.
• Makes all public resources available credential-free.
• Registers zero MCP prompts.

Setup

Using only the existing project scripts:

git clone <repository-url>
cd stocktrends-mcp-server
npm install
npm run build

This git clone + npm install + npm run build sequence, followed by local stdio execution of the compiled dist/server.js, remains fully supported and is the primary install channel for this repository. This package is also publicly available from the npm registry as @stocktrends-publications/stocktrends-mcp-server — see Public npm Installation directly below. A third, distinct install path — a locally built npm package artifact (a local .tgz, not a registry install) — has also been validated cross-platform; see Local Package Artifact Installation below and the Cross-Platform Package Install / Stdio Validation Report.

No environment variables or .env file are required for this path. Do not set STOCKTRENDSENABLEPAIDTOOLS, STOCKTRENDSAPIKEY, or STOCKTRENDSENABLEPAIDEXECUTION while testing default/free mode.

Optional: npm start starts the local stdio server process directly and is mainly useful as a manual smoke check (it will sit waiting for JSON-RPC input on stdin). Stop it with Ctrl+C before launching the server via MCP Inspector below.

Public npm Installation

This package is publicly published to the npm registry as @stocktrends-publications/stocktrends-mcp-server. Anyone can install it by name, credential-free, without cloning this repository:

Shortened. The full README is on GitHub.