.codex-plugin/plugin.json

{
  "name": "timefire",
  "version": "0.1.0",
  "description": "Check Timefire's public record of AI stock forecasts: look up graded books, review the track record and verify each book's seal. Read-only, no account needed.",
  "author": {
    "name": "Timefire",
    "email": "dev@timefire.ai",
    "url": "https://timefire.ai"
  },
  "homepage": "https://timefire.ai/developers/mcp/",
  "repository": "https://github.com/timefire-ai/timefire-plugin",
  "license": "MIT",
  "keywords": [
    "stocks",
    "forecasts",
    "track record",
    "verification",
    "S&P 500"
  ],
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Timefire",
    "shortDescription": "Graded stock forecast record",
    "longDescription": "Timefire publishes a daily book of AI forecasts across the S&P 500 and grades each book ten trading days later. Look up graded books, see the hit rate, follow one stock's history, view the simulated portfolio against RSP, and verify that a book existed before its outcome was known. Read-only, with no account needed. Timefire does not place trades, give live prices or give personal financial advice.",
    "developerName": "Timefire",
    "capabilities": [
      "Look up graded books",
      "Review the track record",
      "Verify a book's seal"
    ],
    "websiteURL": "https://timefire.ai",
    "supportURL": "https://timefire.ai/developers/mcp/#support",
    "privacyPolicyURL": "https://timefire.ai/legal/privacy/",
    "termsOfServiceURL": "https://timefire.ai/legal/terms/",
    "defaultPrompt": [
      "Use Timefire to verify the newest graded book.",
      "Using Timefire, what is the hit rate across every graded book?",
      "Show me every graded Timefire book that included Apple."
    ],
    "composerIcon": "./assets/logo.png",
    "logo": "./assets/logo.png",
    "category": "Finance"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Verifies the newest graded book and explains what its timestamp proves.",
              "prompt": "Use Timefire to verify the newest graded book and tell me what the timestamp proves.",
              "tools_triggered": "list_resolved_batches, verify_batch",
              "expected_behavior": "Names the newest graded book's date. Explains that the timestamp shows the book's contents existed by that time, and says what it doesn't prove."
            },
            {
              "description": "Reports the hit rate across graded books.",
              "prompt": "Using Timefire, what is the hit rate across every graded book?",
              "tools_triggered": "get_track_record_stats",
              "expected_behavior": "Gives the hit rate and the number of graded books, keeping books under the published rule separate from the earlier backtest books."
            },
            {
              "description": "Lists graded books for one ticker.",
              "prompt": "Show me every graded Timefire book that included Apple.",
              "tools_triggered": "get_stock_resolved_history",
              "expected_behavior": "Lists Apple's graded book dates and separates long picks, short picks and books where it was ranked but not picked."
            },
            {
              "description": "Shows the paper portfolio on equal weights against RSP.",
              "prompt": "Show me Timefire's equal-weighted portfolio value against RSP.",
              "tools_triggered": "get_simulation_nav",
              "expected_behavior": "Gives the portfolio's value against RSP over the same dates, and says the figures are simulated."
            },
            {
              "description": "Explains the stored evidence for one forecast in a graded book.",
              "prompt": "Using Timefire, what evidence sits behind the WMB forecast in the 2026-10-23 book?",
              "tools_triggered": "explain_resolved_prediction",
              "expected_behavior": "Gives WMB's forecast and rank in that book, plus the stored context and news items."
            }
          ],
          "negative": [
            {
              "description": "Timefire can't trade, and the plugin must not imply it can. The assistant should say it can't place the order, and no Timefire tool should run.",
              "prompt": "Buy 10 shares of Apple for me."
            },
            {
              "description": "Timefire has no live quotes. No Timefire tool should run; the assistant answers from another source or says it can't.",
              "prompt": "What is Apple's share price right now?"
            },
            {
              "description": "Timefire gives no personal advice. No Timefire tool should run; the assistant gives general guidance or suggests a qualified adviser.",
              "prompt": "Should I put my savings into index funds?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Timefire does not sell products or process payments."
      },
      "publication": {
        "release_notes": "First release: read-only access to Timefire's graded forecast books, track record, simulated portfolio and seal verification."
      }
    }
  },
  "apps": "./.app.json"
}