Skip to content
MCP server

Timefire

Look up Timefire's graded AI stock forecast books and verify their timestamps

Install
Pricing
Free
Platforms
API
Runs
Remotely
Version
0.1.1
Listing updated
3 days ago

About Timefire

Timefire is a free MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

Timefire seals each book of stock forecasts before outcomes are known, then grades it ten trading days later. This server gives an assistant read access to that record, so questions such as whether the newest graded book can be verified, what the hit rate is across graded books, or which books included a given ticker can be answered from the source.

It never returns an ungraded book, needs no account and is read-only. The plugin documentation counts 12 tools, listed on a separate developer page, and sample prompts include comparing an equal-weighted portfolio value against RSP.

Setup pages cover many clients: Claude, Claude Code, ChatGPT developer mode, Codex, Grok, Cursor, VS Code, Perplexity, Replit, Gemini CLI, Gemini Enterprise, Cline and Zed. Tool inputs such as a date, ticker or search words go to api.timefire.ai, and the project states it is not investment advice.

Install

Run in a terminal

claude mcp add --transport http record https://api.timefire.ai/mcp/

Add to Settings → Connectors → Add custom connector

https://api.timefire.ai/mcp/
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "record": {
      "url": "https://api.timefire.ai/mcp/"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "record": {
      "type": "http",
      "url": "https://api.timefire.ai/mcp/"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "record": {
      "serverUrl": "https://api.timefire.ai/mcp/"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "record": {
      "type": "http",
      "url": "https://api.timefire.ai/mcp/"
    }
  }
}

Tools this server provides (12)

Read directly from the server.

list_resolved_batches
List graded books, newest first, one summary row each: date, returns, alpha against SPY and RSP, and verdict. A book (or batch) is one trading day's full S&P 500 slate. Use this to find a trading_date, then get_resolved_batch for every forecast in that book or verify_batch for its proof. Dates with no graded book return an empty list.
get_resolved_batch
Get one graded book with every forecast and its outcome. A book (or batch) is one trading day's full S&P 500 slate, served once its long picks are fully graded, so other rows can still have null outcomes. Use list_resolved_batches to find the date, verify_batch for the book's proof and get_book_portfolio for its portfolio. An ungraded or unknown date is an error.
get_track_record_stats
Get aggregates computed only from fully resolved books: forecast counts, returns and hit rates, and how many books beat, matched (flat) or trailed SPY, each book's verdict graded on its cap-weighted long picks. The hit rates count the books graded under the published rule, from published_rule_from on; the 69 backtest books before it follow a rule of their own and are reported apart in the backtest
get_calibration
Check whether forecasts matched outcomes: mean predicted against mean realized return by decile across every graded book, and hit rates by rank bucket and by side (long or short) across books graded under the published rule. Use this to judge how well the ranking held up, and get_track_record_stats for headline returns and the verdict tally.
get_universe_and_scoring_spec
Get the versioned scoring rules, the metric definitions and the latest graded book's universe of stocks. Use this before interpreting a stat or a verdict, to learn how books are graded and which stocks are covered.
get_stock_resolved_history
Get one stock's rows from graded books only, newest first: its forecast, rank, pick side and outcome in each book. Use this to follow one ticker across books, explain_resolved_prediction for the evidence behind one row, and get_resolved_batch for a whole book. An unknown ticker returns an empty list.
verify_batch
Get the public proof for one graded book: signed payload, hash, signature, content address and timestamp material, with the steps to check them. The verified field is the server's own check; the evidence lets you repeat it yourself. Use this to check a book's signature and timestamp, and get_resolved_batch to read its forecasts and outcomes. An ungraded or unknown date is an error.
get_book_portfolio
Get a resolved book's portfolio: market-cap-weighted vs SPY ("cap", the default, the portfolio the ledger's verdict grades) or equal-weighted vs RSP ("equal"), with each long pick's weight and graded return, the book return, the benchmark return and its evidence, alpha and verdict. Equal weights always pair with RSP and cap weights with SPY. Per prediction, books serve the two as equal_weight and
search_docs
Find the developer guides and site pages that match a few words. Each hit carries the page title, its canonical URL and a short excerpt. Use this for how Timefire works and what its terms mean, not for record data. No match returns an empty list, so try other words.
get_simulation_nav
Get the paper portfolio's daily value (NAV), market-cap-weighted vs SPY ("cap", the default) or equal-weighted vs RSP ("equal"), with both benchmarks on every row. There is one row per resolved trading day. The series stops at the newest date by which every book is revealed, because a later value holds positions from books still sealed. Use this for portfolio value over time, and get_simulation_tr
get_simulation_trades
Get the paper portfolio's closed trades from resolved books, newest first, market-cap-weighted ("cap", the default) or equal-weighted ("equal"): the two trade at the same prices and differ in weight, and so in size and P&L. Open positions never appear. Date bounds apply to the day a trade opened; narrow them to see past the limit. Use this for individual trades, and get_simulation_nav for portfoli
explain_resolved_prediction
Get the stored evidence behind one stock's forecast in a graded book: its rank, side, market regime, 5- and 20-day lookback returns, news items and notes. Use this to see the context a stock was ranked in, and get_stock_resolved_history to find which books hold it. An ungraded date, or a ticker not in that book, is an error.

What it does

Graded books only
Sealed books are never returned before grading.
Seal verification
Check what a book's timestamp proves.
Track record
Review hit rate across all graded books.
Ticker lookup
Find every graded book that included a given stock.
No account
Connect with one URL and no authentication.
Wide client support
Setup steps for many MCP clients.

Good for

  • Verify the newest graded forecast book
  • Compute the hit rate across graded books
  • See which books held a given ticker
  • Compare portfolio value with RSP

Pricing

Free

No account or key needed

Prices change. Check timefire.ai before you buy.

Timefire FAQ

Do I need to sign in?

No. The server is read-only and needs no account.

When is a book graded?

Ten trading days after it is sealed.

What data leaves my machine?

Only the tool inputs, such as a date, ticker or search words, sent to api.timefire.ai.

Is it investment advice?

No; the README says it is not.

Is Timefire free?

Yes. Timefire is free to use.

How do I add Timefire to Claude Code?

Run this command in your terminal: claude mcp add --transport http record https://api.timefire.ai/mcp/

What are the best alternatives to Timefire?

The closest alternatives to Timefire are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to Timefire

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments