# Timefire

> Timefire is a free MCP server for finance and payments. Look up Timefire's graded AI stock forecast books and verify their timestamps. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://timefire.ai/developers/mcp/
- **Repository:** https://github.com/timefire-ai/timefire-plugin
- **MCP Registry name:** ai.timefire/record
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.timefire.ai/mcp/
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "record": {
      "url": "https://api.timefire.ai/mcp/"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/timefire
