coreforge-trading-mcp
v1.0.1
Published
MCP server for CoreForge trading analytics: strategy signals, signal board, market regime, backtests, indicators, portfolio risk, options Greeks, catalyst classification, US gov-contract awards, token analytics and Base chain reads — pay-per-call via x402
Maintainers
Readme
CoreForge Trading — MCP server
Trading-analytics tools from Creator CoreForge, exposed as a Model Context Protocol (MCP) server over stdio.
Computed data only. These tools run deterministic, published rule sets and formulas over market data. Nothing here is financial advice, a recommendation, or a promise of performance — every API response carries that disclosure, and the tools pass it through.
The tools call the CoreForge x402 API, which is pay-per-call in USDC on Base mainnet (x402 protocol). Two modes:
- Quote-only mode (default): no wallet configured. Paid tools return the endpoint's payment requirements — amount, asset, network and payTo address — as a structured result.
- Auto-pay mode: set
X402_PAYER_PRIVATE_KEYto a dedicated, low-balance wallet holding USDC on Base. Each paid tool call then pays automatically via@x402/fetch. Never use a wallet with funds you cannot afford to spend.
Tools
| Tool | Price | What it does |
|---|---|---|
| trading_signal | $0.02 | Strategy states (5 rule sets + ensemble) for one symbol; Coinversa sentiment for BTC/ETH/SOL. |
| trading_signals_board | $0.05 | Full-universe snapshot: 16 equities/ETFs + BTC, ETH, SOL. |
| trading_regime | $0.05 | 9-state market-regime classification + per-regime strategy weights. |
| trading_backtest | $0.05 | Backtest with in-sample / out-of-sample walk-forward; optional Monte Carlo. |
| trading_indicators | $0.01 | SMA/EMA/RSI/MACD/Bollinger on bars you supply (no external fetch). |
| portfolio_risk | $0.05 | Volatility, Sharpe/Sortino, drawdown, VaR/CVaR, correlation/concentration; optional stress tests + Monte Carlo. |
| options_greeks | $0.02 | Black-Scholes chain generation or multi-leg payoff analysis. Model values, no live quotes. |
| catalyst_classify | $0.01 | Classify headlines into catalyst categories. Classification only. |
| gov_contracts | $0.02 | Recent US federal contract awards (USAspending.gov), tickers resolved where confident. |
| token_analytics | $0.05 | Raw DEX market-data bundle for a token (price, liquidity, volume, pairs). No scores. |
| chain_balance | $0.002 | Base: native ETH balance of an address. |
| chain_token_balance | $0.003 | Base: ERC-20 balance of an address (symbol/decimals resolved). |
| chain_block | $0.001 | Base: latest block number/hash/timestamp. |
| chain_gas | $0.001 | Base: current gas price. |
Install
npm install
node src/index.js # serves MCP over stdioMCP client configuration (Claude Desktop, Cursor, etc.):
{
"mcpServers": {
"coreforge-trading": {
"command": "npx",
"args": ["-y", "coreforge-trading-mcp"],
"env": {
"X402_BASE_URL": "https://coreforge-memory.onrender.com/x402",
"X402_PAYER_PRIVATE_KEY": ""
}
}
}
}(Until the package is published to npm, run it from a clone of this repo with node /path/to/coreforge-trading/src/index.js as the command.)
Configuration
| Env var | Required | Description |
|---|---|---|
| X402_BASE_URL | no | Base URL of the CoreForge x402 API. Default: https://coreforge-memory.onrender.com/x402. |
| X402_PAYER_PRIVATE_KEY | no | Private key (0x…) of a dedicated low-balance wallet with USDC on Base mainnet (eip155:8453). Enables automatic payment. Empty/unset = quote-only mode. |
See .env.example. No secrets are stored in this repository.
Notes
- Prices are set by the API server and can change; the 402 response always carries the current amount, and quote-only mode shows it before any payment.
- The signal board, regime and gov-contracts tools compute over live market/public data and can take up to ~2 minutes to answer.
