← FXAbsolute For developers

Connect your coding agent to FXAbsolute

MCP SERVER · FREE · NO API KEY · UPDATED AUGUST 2026

Your agent should not have to read prices off a screenshot. This MCP server hands it the numbers instead: five years of 1-minute candles across 15 instruments, and a live bridge to the chart you are backtesting right now.

Tool access needs a data contract

CHECK 29

Make the agent state what it read, calculated, and could not observe

Connecting a coding agent to historical candles reduces transcription work, but it does not make the model a market oracle. Begin each task with an instrument and data inventory, then require the agent to show query dates, timeframe aggregation, sample size, missing fields, exclusions, and the exact calculation behind every conclusion.

Protect replay integrity separately. A tool may technically access bars beyond the chart position even when the prompt asks it not to. Use bounded date parameters or a server-side replay boundary for any exercise where future leakage would invalidate the decision.

Data boundary

Confirm available symbols, fields, coverage, gaps, timezone, aggregation, and whether prices are midpoint, bid, or ask.

Tool boundary

List each tool the client can call, its read or write effect, response limits, and whether it can reach future data or the live chart.

Claim boundary

Separate measured output, implementation assumptions, and model-generated explanations in the final answer.

  1. Call the inventory tool before requesting analysis.
  2. Ask for the query manifest and denominator with every result.
  3. Run a small hand-calculated case to verify aggregation and units.
  4. Save prompts, tool outputs, versions, and errors for reproduction.

A useful trading agent is an auditable calculator with explicit limits, not a confident narrator with hidden inputs.

Install

One command. Node 18 or newer.

claude mcp add fxabsolute -- npx -y fxabsolute-mcp

For any other MCP client, add this to its config:

{
  "mcpServers": {
    "fxabsolute": {
      "command": "npx",
      "args": ["-y", "fxabsolute-mcp"]
    }
  }
}

No API key, no account, no cost. FXAbsolute pays for no inference — you bring the agent you already use, and it thinks on your side of the wire.

Ask it something immediately

Once installed, the data tools work on their own — you do not need a chart open. Try asking your agent:

Pair it with your live chart

  1. Start a backtest on fxabsolute.com.
  2. Switch the right-hand panel to the AI tab.
  3. Tell your agent: connect to fxabsolute with code ABC123, using the six characters shown.
  4. Type in the panel, or press the microphone and talk.

Every message carries a snapshot of the chart: instrument, timeframe, replay position, the current candle, your open trades, running performance, and every drawing as real geometry. A trendline arrives as its height in pips, the bars it spans and its slope per bar — not as an image the model has to squint at.

The snapshot also states where you are in the replay and tells the agent not to reveal bars you have not reached. An assistant that spoils the next candle would make backtesting pointless.

The tools

ToolWhat it answers
fxa_instrumentsWhat is available, how many bars, which fields exist
fxa_candlesOHLC over a date range, any timeframe from M1 to W1
fxa_session_scanSpecific bars of a trading session across months, summarised
fxa_bucket_statsMovement grouped by hour, weekday, month or year
fxa_level_touchesWhether a price level held, and the reaction it produced
fxa_connect_chartPair with an open chart using its code
fxa_wait_for_messageWait for what the trader says, with the chart attached
fxa_replyAnswer into the trader's panel
fxa_set_thinkingShow the thinking indicator during a long lookup
fxa_disconnect_chartLeave the session

The data

Two things stated plainly

There is no volume. The record is 20 bytes — a timestamp and four float32 OHLC values. Volume was never stored, so no tool reports it and none quietly substitutes a proxy. Bar range is offered instead, and every relevant response says so.

Timeframes are bucketed on wall-clock time, not by array index. Forex data has weekend and holiday gaps, so grouping every 60 one-minute bars eventually stops lining up with a real clock hour and an “H1 candle” can straddle a weekend. Here bars sit on true period boundaries, and a gap produces no bar rather than a fabricated one. Session windows resolve in exchange-local time with daylight saving handled to the second, so the 09:30 bar is the 09:30 bar in both January and July.

fxa_session_scan also reports how many weekdays in your window produced no data at all — worth reading, because a scan can otherwise return healthy-looking statistics built on a fifth less data than you asked for.

Open a chart and pair it

Free, no sign-in, 15 instruments, five years of real data.

Start backtesting

Questions

Do I need an API key?

No. FXAbsolute holds no key and pays for no inference. You connect the agent you already use, and it does the thinking on your side.

Which agents work?

Any MCP-capable client — Claude Code, the Claude desktop app, Codex, Cursor and others. The server speaks stdio and needs Node 18 or newer.

Does it send screenshots of my chart?

No. Drawings are stored as time and price anchors, so they are described numerically. That is more precise than an image and costs a fraction of the tokens.

Can my agent see trades I have not taken yet?

The snapshot states your replay position and instructs the agent not to reveal bars beyond it. The data tools can reach any date, so ask it outright if you want the future — it just will not volunteer it.

Where does the code live?

On GitHub at varsansri/fxabsolute-mcp, MIT licensed.

Beginner exploration

Three questions to help you use this page

Open each answer for a plain-language way to read Connect your coding agent to FXAbsolute, test it carefully and decide what to explore next.

What does “Connect your coding agent to FXAbsolute” mean for a beginner?

This page focuses on “Connect your coding agent to FXAbsolute”.Connect an agent to forex data with an explicit data contract, bounded replay access, query manifests, hand checks and reproducible tool outputs.For “Connect your coding agent to FXAbsolute”, a beginner should identify what the AI workflow guide measures, assumes or teaches before acting on its conclusion.Treat this page's account of “Connect your coding agent to FXAbsolute” as a learning reference rather than a prediction, signal or promise of future performance.

How should a beginner use this page to explore “Connect your coding agent to FXAbsolute”?

For “Connect your coding agent to FXAbsolute”, give the model explicit data, rules, units, dates and output requirements instead of asking for a vague trading opinion.While exploring “Connect your coding agent to FXAbsolute”, require calculations, assumptions and rejected cases to remain inspectable.Keep your “Connect your coding agent to FXAbsolute” record honest: verify arithmetic and execution logic outside the language model whenever the result affects a decision.Before leaving “Connect your coding agent to FXAbsolute”, keep an untouched holdout because repeated prompting can overfit just like repeated parameter searches.

How can AI help explore “Connect your coding agent to FXAbsolute” responsibly?

Turn one idea from “Connect your coding agent to FXAbsolute” into a rule with explicit inputs, dates, costs and pass-or-fail conditions.Ask AI to expose missing assumptions in that “Connect your coding agent to FXAbsolute” test, not to guess the next market move.Use the FXAbsolute AI Backtesting Lab to inspect calculations connected to “Connect your coding agent to FXAbsolute” and the assumptions behind them.Reproduce any important “Connect your coding agent to FXAbsolute” result and reserve unseen data before deciding that an apparent pattern is useful.

Continue your exploration of Connect your coding agent to FXAbsolute with the beginner AI prompt guide, or inspect public calculations in the AI Backtesting Lab.