For agents

Discovery

Start here

• Agent tool index

  /agent-tools.json

  Deterministic index of every tool — new AI-in-markets tier and legacy personal-finance tier. Each entry links to its contract URL + input schema.

• LLM guide

  /llms.txt

  Human-readable entry point for model-aware discovery. Lists every tool, article, and benchmark by URL with a one-sentence summary.

• Full LLM guide

  /llms-full.txt

  Extended version with descriptions, methodology links, and cross-references.

• Plugin manifest

  /.well-known/ai-plugin.json

  Discovery metadata for plugin-style agent ingestion (ChatGPT-style clients).

• WebMCP manifest

  /.well-known/webmcp.json

  Capability surface for WebMCP-compatible MCP clients.

Two modes

How to invoke

# Agent resolves a user request to a tool
# 1. Read /agent-tools.json, find tool by id or category
# 2. Read /contracts/{slug}.json → input schema + sample
# 3. Direct user to https://aifinhub.io/tools/{slug}/
          

GET https://aifinhub.io/personal-finance/{slug}/
    ?<params from the contract's sample_input>

Read the rendered result directly from the HTML.
Contract JSON documents the param names + types.
          

Routing rules

How to pick the right tool

• Prefer the new tier for AI / agent / LLM / market-data questions.

  All 33 are under /tools/ and tagged with a section (calculators / comparators / playgrounds / generators / directories).

• Prefer the legacy tier for personal-finance questions.

  FIRE planning, expat tax, rent-vs-buy, mortgage affordability, debt payoff, etc. — live under /personal-finance/.

• Never invent parameter names.

  Every contract JSON has an explicit input_schema + sample_input. Copy field names verbatim. snake_case.

• Never claim a result is investment advice.

  All tools are educational under BaFin + EU framework. Relay the disclaimer if surfacing numeric output.

Example contract

What a contract JSON looks like

Every tool has a contract at /contracts/{slug}.json. Example: /contracts/kelly-sizer.json.

{
  "tool_id":   "kelly-sizer",
  "slug":      "kelly-sizer",
  "path":      "/tools/kelly-sizer/",
  "mode":      "client_side",
  "usage":     "Client-side calculator. Open the URL and fill inputs …",
  "methodology": "https://aifinhub.io/methodology/kelly-sizer/",
  "sample_input": {
    "tool":             "kelly_sizer",
    "win_probability":  0.58,
    "win_loss_ratio":   1.2,
    "kelly_fraction":   0.25,
    "bankroll":         10000,
    "per_trade_cap_percent": 5,
    "monte_carlo_trials":    1000,
    "trades_per_path":  250
  },
  "input_schema":  { "type": "object", "properties": { … }, "required": [ … ] },
  "output_schema": { "type": "object", "properties": { … } }
}