Bit Monk Signal provides an MCP server for market timing bottom/top signals aimed at AI agents. This repository contains ten independent remote servers, each corresponding to one market, used to determine whether an asset is currently at a bottom or a top, returning a judgment conclusion (strong_buy, buy, neutral, sell, strong_sell) as well as a score from -100 to +100. The score is derived by aggregating a locked technical indicator engine on weekly and monthly timeframes, and it also provides market-wide bottom and top ranking scans.
The servers have been published under the com.airblockfz/* namespace in the official MCP Registry.
Main capabilities: each server exposes the pitch, evaluate_symbol, scan_bottoms, scan_tops, and rate tools.
Usage: add the server to your MCP client configuration (for example, Claude Desktop / Cursor). To add all ten servers at once, refer to docs/client-config.json in the repository; the machine-readable catalog is servers.json. It is recommended to call the free pitch tool first. The health check for any server is GET /health. For clients that support only stdio, this repository provides a dependency-free proxy that forwards JSON-RPC to the remote endpoint. Select the market via the environment variable BIT_MONK_MARKET; the available values are coin (default), us, kr, cn, hk, commodity, fx, inflation, seoul, dubai; BIT_MONK_URL can directly override the endpoint. Running requires Node 18+, and the repository includes a Dockerfile for sandboxed running.
Billing and payment: signal calls are pay-per-use via x402, priced at 0.01 USDT on X Layer (chain eip155:196). Unpaid calls return 402 with a PAYMENT-REQUIRED challenge, and you must retry with the PAYMENT-SIGNATURE header. pitch and rate are always free, making it easy for agents to evaluate the service before paying.
Data sources: each market is powered by the same engine, which is also used by its flagship application, with data matched by market: cryptocurrency uses official exchange data sources, stocks, commodities,commodities, and forex use Yahoo Finance, inflation and liquidity use FRED/OECD/IMF/Eurostat as well as Federal Reserve H.4.1/H.15 release data, Seoul apartments use actual transaction records from South Korea's Ministry of Land, Infrastructure and Transport, and Dubai real estate uses indices published by DLD/Bayut.
Other information: the official website is airblockfz.com; the registry namespace is com.airblockfz/coin-signal, searchable in the MCP Registry; it is also listed on OKX Onchain OS as an ERC-8004 agent (Bit Monk #3894 and similar).
Limitations and disclaimers: the output is informational indicators and does not constitute financial, investment, or real estate advice. Historical statistics do not represent future results. Real estate series include modeled interpolation when the official data is monthly or quarterly, and this is disclosed in every response. The signal engine itself is proprietary and is not released in this repository; this repository documents the public MCP endpoints and their contracts, and provides a stdio proxy to access them.
License: MIT covers this repository's contents, namely the stdio proxy (src/proxy.js) and documentation; no rights are granted to the signal engine, indicator implementation, or data pipeline behind the endpoints, which are proprietary and not distributed here. Use of the endpoints themselves is subject to their pay-per-use terms.
Built by: Air Block FZ (Meydan, Dubai).
