Wickworks MCP server
Commit Nov 10, 2026Analyzes OHLC bars to provide technical indicators and smart-money-concepts for financial market analysis.
Also known as psyb0t/docker-wickworks, docker-wickworks
- Stars
- 5
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.7.2
- Last commit
- Nov 10, 2026
- License
- WTFPL
What is Wickworks MCP?
Wickworks analyzes OHLC bars to provide technical indicators and smart-money-concepts for financial market analysis.
Summary generated from the project's README
About Wickworks MCP server
Analyzing OHLC bars to extract technical indicators and smart-money-concepts is what Wickworks enables for financial developers and algorithmic traders. By sending price data via HTTP to a stateless FastAPI server, users receive precise mathematical outputs including RSI, MACD, Bollinger Bands, and order blocks. The system avoids providing subjective trading signals, focusing instead on delivering raw data like fair value gaps or swing levels to be used within your own custom strategies.
This server runs locally via Docker and can be integrated into AI agents using the MCP protocol through the compute, metadata, list_indicators, and health tools. It is compatible with Claude Code, Codex, and OpenClaw. Because the server has no built-in authentication, it is designed to be run on a loopback interface or behind a proxy. Users must provide sufficient historical bars, such as at least 50 for smart-money-concept outputs, to ensure accurate calculations.
Written from the project's README. Every use case is checked against a quote from it.
How to install Wickworks MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Wickworks MCP in Claude Code
$ claude mcp add docker-wickworks -- docker run -i --rm docker.io/psyb0t/wickworks:v0.7.2Install Wickworks MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"docker-wickworks": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/psyb0t/wickworks:v0.7.2"
]
}
}
}Install Wickworks MCP in VS Code
.vscode/mcp.json
{
"servers": {
"docker-wickworks": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/psyb0t/wickworks:v0.7.2"
]
}
}
}Install Wickworks MCP in VS Code CLI
$ code --add-mcp '{"name":"docker-wickworks","type":"stdio","command":"docker","args":["run","-i","--rm","docker.io/psyb0t/wickworks:v0.7.2"]}'Install Wickworks MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"docker-wickworks": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/psyb0t/wickworks:v0.7.2"
]
}
}
}Install Wickworks MCP in Codex
$ codex mcp add docker-wickworks -- docker run -i --rm docker.io/psyb0t/wickworks:v0.7.2Install Wickworks MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.docker-wickworks] command = "docker" args = ["run", "-i", "--rm", "docker.io/psyb0t/wickworks:v0.7.2"]
Install Wickworks MCP in Gemini CLI
$ gemini mcp add -s user docker-wickworks docker -- run -i --rm docker.io/psyb0t/wickworks:v0.7.2Install Wickworks MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"docker-wickworks": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/psyb0t/wickworks:v0.7.2"
]
}
}
}Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablePass
- Open source license (OSI)WTFPL is not OSI-approvedFinding
- Commit or release in the last yearPass
- Package name not close to a popular packageNot checked
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHubwickworks
The dumb-as-rocks OHLC analyzer. You throw bars at it over HTTP, it throws indicators and SMC objects back. That's the whole product. No database, no queue, no state, no opinions, no "AI-powered signals," no upsell to a $97/mo Discord. Just the numbers.
Every snake-oil-flavored TA SaaS out there wants to tell you when to buy. Wickworks tells you the order block is at 1.0832 and the RSI is 71.4. The "what does that mean?" part is where your strategy lives, and it should live in your code, not behind someone else's paywall.
Built on pandas-ta and smartmoneyconcepts, wrapped in a FastAPI server with an MCP endpoint, locked behind 377 tests, including formulas written from scratch and diffed against the output on real EURUSD bars. If a math bug slips in, the test suite screams before the image ships.
Table of Contents
What's inside
| Category | What you can ask for |
|---|---|
| Trend | SMA/EMA + 15 other moving averages, Donchian channels, Ichimoku, Aroon, Vortex, supertrend, PSAR, chandelier exit |
| Momentum | RSI, MACD, Stochastic, StochRSI, ADX, MFI, CCI, Williams %R, ROC, MOM, TSI, TRIX, UO, Fisher |
| Volatility | ATR, NATR, Bollinger Bands, Keltner Channels, TTM Squeeze |
| Volume | VWAP (anchored), VWMA, OBV, AD, ADOSC, CMF, KVO |
| SMC | Order blocks, fair value gaps, BOS/CHoCH, swing levels, S/R levels, liquidity, retracements, sessions, previous-period high/low |
| Summaries | Price, levels, momentum, volume, position, slope: last-bar snapshots in one call |
All JSON field names are camelCase. NaN becomes null, never a literal NaN token that blows up downstream parsers. Bars in UTC, math in UTC, container runs TZ=UTC. Timezone bullshit is your problem, not mine.
Quick start
docker run --rm -p 127.0.0.1:8000:8000 psyb0t/wickworks:latest
Send bars plus the indicators you want. You get back only what you asked for, under the names you picked:
curl -s -X POST http://localhost:8000/ \
-H 'Content-Type: application/json' \
-d @request.json
{
"symbol": "EURUSD",
"timeframe": "H1",
"bars": [
{
"time": 1700000000,
"open": 1.0832,
"high": 1.0851,
"low": 1.0828,
"close": 1.0844,
"volume": 1247
}
],
"indicators": {
"rsi": true,
"rsi21": {
"type": "rsi",
"length": 21
},
"stochFast": {
"type": "stoch",
"k": 5,
"d": 3
},
"macd": true,
"orderBlocks": true
}
}
The response holds symbol, timeframe, candles, rsi, rsi21, stochFast, macd and orderBlocks. Nothing else. Send enough bars for what you ask (at least 50 for the SMC outputs); if you don't, the 400 lists every under-fed indicator at once. wickworks has no auth, so keep the port on loopback or behind a proxy that does auth.
The REST API page has the full request rules, response shapes and errors.
MCP and agents
The same compute runs over a stateless streamable-HTTP MCP server at /mcp on the same port, with the tools health, list_indicators, metadata and compute:
claude mcp add --transport http wickworks http://localhost:8000/mcp
The skill works in any agent that reads .agents/skills/ (such as peen), and installs natively in Claude Code, Codex and OpenClaw:
claude plugin marketplace add psyb0t/agents
claude plugin install wickworks@psyb0t
codex plugin marketplace add psyb0t/agents
codex plugin add wickworks@psyb0t
openclaw skills install @psyb0t/wickworks
The agent integrations page covers the stdio bridge plugin and tokens.
Documentation
The full documentation lives at psyb0t.github.io/docker-wickworks.
| Section | What it covers |
|---|---|
| Install and run | docker run, compose, tags, platforms, scaling, upgrades |
| Configuration | Every environment variable and its default |
| REST API | Endpoints, request and response shapes, errors |
| Indicator reference | Every series indicator with parameters and outputs |
| SMC and summaries | Order blocks, FVGs, structure, S/R, sessions and the summaries |
| MCP server | The /mcp endpoint and its tools |
| Agent integrations | Claude Code, Codex and OpenClaw |
| Security | No auth, exposure, input limits |
| Troubleshooting | Every error message and its fix |
| Architecture | How a request flows, determinism |
| Development | Tests, dependencies, CI and releases |
The machine-readable contract is schema.json (JSON Schema Draft 2020-12).
Development
Docker and Make are all you need. Every target runs in a dev container.
make help # list targets
make run # uvicorn on :8000 in the dev container
make lint # flake8 + mypy
make test-unit # in-process tests, the fast loop
make test # unit + docker integration tests, what CI runs
make docs # build the documentation site
Dependencies only change through the make pkg-* targets, which move uv's exclude-newer cutoff to today first. The development page explains why, plus the test suite, CI and releases.
Sponsor
License
WTFPL, see LICENSE. Do what the fuck you want. The numba port in smc_fast.py keeps its upstream MIT license, see THIRD_PARTY.md.
Wickworks MCP questions
How do I add Wickworks MCP to Claude Code?
Run claude mcp add docker-wickworks -- docker run -i --rm docker.io/psyb0t/wickworks:v0.7.2 in your terminal. Add --scope user to make it available in every project.
How do I add Wickworks MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What kind of indicators does Wickworks provide?
It provides a wide range of indicators including trend (SMA/EMA, Ichimoku), momentum (RSI, MACD), volatility (Bollinger Bands), volume (VWAP, OBV), and Smart Money Concepts (order blocks, fair value gaps).
Does Wickworks require authentication?
No, Wickworks has no built-in authentication, so it is recommended to keep the port on loopback or use a proxy for security.
How many bars are needed for Smart Money Concepts (SMC) outputs?
You should provide at least 50 bars to ensure the SMC outputs are calculated correctly.