@tickerbot/mcp-server 0.2.1 → 0.3.0

package/README.md

@@ -66,29 +66,43 @@ Add to `.vscode/mcp.json` in your workspace:
 
 ## Tools
 
-19 tools covering tickers, signals, scans, universes, news, and webhook subscriptions.
+33 tools covering scans, signals, tickers (state, history, bars, coverage, ETF holdings), events and their kinds, news, universes and webhook subscriptions (scan, signal, ticker, events and news). Bars and History answer `data`: one symbol gives its rows, a comma list gives them keyed by symbol.
 
 | Tool | Endpoint |
 | --- | --- |
+| `tickerbot_scan` | `POST /v2/scan` |
+| `tickerbot_subscribe_scan` | `POST /v2/scan/subscribe` |
+| `tickerbot_list_signals` | `GET /v2/signals` |
+| `tickerbot_create_custom_signal` | `POST /v2/signals` |
+| `tickerbot_get_signal` | `GET /v2/signals/{signal}` |
+| `tickerbot_update_custom_signal` | `PATCH /v2/signals/{signal}` |
+| `tickerbot_delete_custom_signal` | `DELETE /v2/signals/{signal}` |
+| `tickerbot_subscribe_signal` | `POST /v2/signals/{signal}/subscribe` |
 | `tickerbot_list_tickers` | `GET /v2/tickers` |
 | `tickerbot_get_ticker` | `GET /v2/tickers/{ticker}` |
-| `tickerbot_get_ticker_history` | `GET /v2/tickers/{ticker}/history` |
-| `tickerbot_get_ticker_events` | `GET /v2/tickers/{ticker}/events` |
-| `tickerbot_list_signals_catalog` | `GET /v2/signals` |
-| `tickerbot_get_signals_match` | `GET /v2/signals/{signal}` |
-| `tickerbot_get_signal_history` | `GET /v2/signals/{signal}/{ticker}/history/{interval}` |
-| `tickerbot_list_signal_events` | `GET /v2/signals/{signal}/{ticker}/events` |
-| `tickerbot_scan` | `GET /v2/scan` (live or `asof`) |
+| `tickerbot_get_history` | `GET /v2/tickers/{ticker}/history` |
+| `tickerbot_subscribe_ticker` | `POST /v2/tickers/{ticker}/subscribe` |
+| `tickerbot_get_bars` | `GET /v2/tickers/{ticker}/bars/{interval}` |
+| `tickerbot_get_ticker_coverage` | `GET /v2/tickers/{ticker}/coverage` |
+| `tickerbot_get_etf_holdings` | `GET /v2/tickers/{ticker}/holdings` |
+| `tickerbot_list_events` | `GET /v2/events` |
+| `tickerbot_list_event_kinds` | `GET /v2/events/kinds` |
+| `tickerbot_subscribe_events` | `POST /v2/events/subscribe` |
+| `tickerbot_search_news` | `GET /v2/news` |
+| `tickerbot_subscribe_news` | `POST /v2/news/subscribe` |
 | `tickerbot_list_universes` | `GET /v2/universes` |
-| `tickerbot_get_universe` | `GET /v2/universes/{id}` |
 | `tickerbot_create_universe` | `POST /v2/universes` |
-| `tickerbot_create_custom_signal` | `POST /v2/signals` |
-| `tickerbot_search_news` | `GET /v2/news/scan` |
-| `tickerbot_subscribe_scan` | `POST /v2/scan/subscribe` |
-| `tickerbot_subscribe_signal` | `POST /v2/signals/{signal}/subscribe` |
-| `tickerbot_subscribe_ticker` | `POST /v2/tickers/{ticker}/subscribe` |
+| `tickerbot_get_universe` | `GET /v2/universes/{id}` |
+| `tickerbot_update_universe` | `PATCH /v2/universes/{id}` |
+| `tickerbot_delete_universe` | `DELETE /v2/universes/{id}` |
 | `tickerbot_list_webhooks` | `GET /v2/webhooks` |
+| `tickerbot_get_webhook` | `GET /v2/webhooks/{id}` |
+| `tickerbot_update_webhook` | `PATCH /v2/webhooks/{id}` |
 | `tickerbot_delete_webhook` | `DELETE /v2/webhooks/{id}` |
+| `tickerbot_list_webhook_deliveries` | `GET /v2/webhooks/{id}/deliveries` |
+| `tickerbot_redeliver_webhook_delivery` | `POST /v2/webhooks/{id}/deliveries/{delivery_id}/redeliver` |
+| `tickerbot_enable_webhook` | `POST /v2/webhooks/{id}/enable` |
+| `tickerbot_test_webhook` | `POST /v2/webhooks/{id}/test` |
 
 Strategies are not exposed via MCP — see the [REST API docs](https://tickerbot.io/api) for those.
 

package/dist/handler.js

@@ -115,11 +115,16 @@ function buildRequest(tool, args, baseUrl) {
     for (const [key, value] of Object.entries(args)) {
         if (value === undefined || value === null || value === '')
             continue;
-        const where = tool.endpoint.paramLocation[key];
+        // Declared params first; then the older names the route still accepts
+        // (endpoint.accepts, TB-570), sent where the route reads them. Anything
+        // else is ignored. Mirrors main_service/mcp/handler.js.
+        const where = tool.endpoint.paramLocation[key] ?? tool.endpoint.accepts?.[key];
         if (!where)
             continue; // unknown param, ignore
         if (where === 'path') {
-            const token = `{${key}}`;
+            // An older path-param name fills the slot the docs name it by
+            // (endpoint.pathAliases, TB-570 step 3: `id` → {universe}).
+            const token = `{${tool.endpoint.pathAliases?.[key] ?? key}}`;
             if (!path.includes(token)) {
                 throw new ToolError(`Tool ${tool.name} declares path param "${key}" but path template "${tool.endpoint.path}" has no {${key}} placeholder.`);
             }
@@ -133,6 +138,17 @@ function buildRequest(tool, args, baseUrl) {
             bodyHasContent = true;
         }
     }
+    // Fixed query values the tool always sends (endpoint.fixedQuery, TB-570
+    // step 3: `api_version=2027-01-12` on Bars and History, so they answer
+    // `data` — one symbol: its rows; a comma list: keyed by symbol).
+    for (const [k, v] of Object.entries(tool.endpoint.fixedQuery ?? {}))
+        query.set(k, String(v));
+    // Fixed body fields (endpoint.fixedBody: a deprecated tool built from its
+    // successor, tickerbot_enable_webhook = PATCH `enabled: true`).
+    for (const [k, v] of Object.entries(tool.endpoint.fixedBody ?? {})) {
+        body[k] = v;
+        bodyHasContent = true;
+    }
     // Verify no path placeholders left unfilled
     const unfilled = path.match(/\{([a-zA-Z_]+)\}/);
     if (unfilled) {

package/dist/index.js

@@ -18,8 +18,10 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { tools as bakedTools } from './tools.js';
 import { runTool, ToolError } from './handler.js';
-const SERVER_NAME = '@tickerbot/mcp-server';
-const SERVER_VERSION = '0.1.0';
+import { createRequire } from 'node:module';
+// package.json is the one place the version lives; the hardcoded '0.1.0'
+// this replaced was reported to every client through 0.2.1.
+const { name: SERVER_NAME, version: SERVER_VERSION } = createRequire(import.meta.url)('../package.json');
 const DEFAULT_BASE_URL = 'https://api.tickerbot.io';
 const DISCOVERY_TIMEOUT_MS = 3000;
 async function fetchLiveCatalog(baseUrl) {

package/dist/tools.d.ts

@@ -13,6 +13,18 @@ export interface ToolDef {
         path: string;
         /** Where each declared input param goes. */
         paramLocation: Record<string, ParamLocation>;
+        /** Older names the route still accepts (TB-570): not in the
+         *  inputSchema, but sent where the route reads them if passed. */
+        accepts?: Record<string, ParamLocation>;
+        /** An older path-param name -> the slot the docs name it by (TB-570
+         *  step 3: `id` fills {universe} / {webhook}, `delivery_id` {delivery}). */
+        pathAliases?: Record<string, string>;
+        /** Query values every call sends (TB-570 step 3: `api_version`, so
+         *  Bars and History answer the `data` shape the descriptions name). */
+        fixedQuery?: Record<string, string>;
+        /** Body fields every call sends (a deprecated tool built from its
+         *  successor: tickerbot_enable_webhook is PATCH `enabled: true`). */
+        fixedBody?: Record<string, unknown>;
     };
 }
 interface JsonSchemaProp {