Explorar o código

Add financial astrology guide from David Williams' book

Compiled ideas and techniques from 'Financial Astrology' (David Williams,
AFA 1982/1984/1988) into a structured reference covering:

- Planetary cause of sunspots and terrestrial effects
- Business cycle cycles: Jupiter (11.86yr), Venus (8yr), Node (18.6yr)
- Benner's price cycles (11-9-7 low, 8-9-10 high patterns)
- The 56-year American business pattern
- McWhirter's North Node business cycle
- Stock market cycles: 9.2yr, 38-41 month, Decennial pattern
- Williams' Solar Ingress Method (quarterly forecast technique)
- Williams' Running Total Aspect Method
- Corporation horoscope analysis
- Personal investing natal chart indicators
- Gold/silver/interest rate cycle theories
- Kondratieff wave analysis

Added as MCP resource astro://guides/financial-astrology with agent tips
in transit tools.
Lukas Goldschmidt hai 1 mes
pai
achega
07a48cd45b
Modificáronse 4 ficheiros con 878 adicións e 2 borrados
  1. 433 0
      agent-guides/financial-astrology.md
  2. 433 0
      financial-astrology.md
  3. 6 0
      src/astro_mcp/server.py
  4. 6 2
      src/astro_mcp/tools.py

+ 433 - 0
agent-guides/financial-astrology.md

@@ -0,0 +1,433 @@
+# Financial Astrology — A Compiled Reference
+
+> Compiled from David Williams' *Financial Astrology: How To Forecast Business, and the Stock Market* (American Federation of Astrologers, 1982, 1984, 1988).
+> Additional sources: Edward R. Dewey's *Cycles: The Science of Prediction* (1947), Samuel Benner's *Prophecies of Future Ups and Downs in Prices* (1875), W. D. Gann, N. D. Kondratieff, and various cycle researchers.
+
+---
+
+## Table of Contents
+
+1. [Core Principles](#core-principles)
+2. [The Planetary Cause of Sunspots](#the-planetary-cause-of-sunspots)
+3. [Planetary Cycles in Business and Markets](#planetary-cycles-in-business-and-markets)
+4. [Benner's Price Cycles](#benners-price-cycles)
+5. [The 56-Year Pattern in American Business](#the-56-year-pattern-in-american-business)
+6. [McWhirter's North Node Business Cycle](#mcwhirters-north-node-business-cycle)
+7. [The 9.2-Year Stock Market Cycle](#the-92-year-stock-market-cycle)
+8. [The 38-41 Month Cycle](#the-38-41-month-cycle)
+9. [The Decennial Pattern](#the-decennial-pattern)
+10. [Williams' Solar Ingress Method](#williams-solar-ingress-method)
+11. [Williams' Running Total Aspect Method](#williams-running-total-aspect-method)
+12. [Corporation Horoscope Analysis](#corporation-horoscope-analysis)
+13. [Personal Investing — Natal Chart Indicators](#personal-investing--natal-chart-indicators)
+14. [Which Stock to Buy](#which-stock-to-buy)
+15. [Gold and Silver Price Cycles](#gold-and-silver-price-cycles)
+16. [Interest Rate Cycles](#interest-rate-cycles)
+17. [The Kondratieff Wave](#the-kondratieff-wave)
+18. [Key Planetary Signatures for Markets](#key-planetary-signatures-for-markets)
+19. [Practical Rules and Heuristics](#practical-rules-and-heuristics)
+20. [Sources](#sources)
+
+---
+
+## Core Principles
+
+### The Law of Causality
+Everything that happens is the consequence of a previous state of things. Economic forecasting is predicated upon adequate knowledge of existing conditions. The Law of Periodical Repetition states that everything which has happened once must happen again — not capriciously, but at regular periods.
+
+### The Mental Mood Theory
+Business cycles begin and end in the minds of men. Nervousness about business prospects translates quickly into lower economic activity. Economics and psychology go hand in hand. As Jung stated: "Astrology represents the summation of all the psychological knowledge of Antiquity."
+
+### The Electromagnetic Hypothesis
+At the moment of birth, the resultant magnetic field of the Sun, Moon, and planets produces a type of sensitivity and selectivity in the individual. When a transiting planet re-enters the area of the natal planet, magnetic effects are produced that operate as a cause affecting the individual. Each planet radiates astral energy of a different frequency. The angles (aspects) between planets determine whether energies combine into harmony or discord.
+
+### Aspect Polarities
+- **Harmonious aspects**: 60° (sextile), 120° (trine) — favorable conditions
+- **Inharmonious aspects**: 0° (conjunction), 90° (square), 180° (opposition) — unfavorable conditions
+- **Orbs of influence**: conjunction 10°, opposition 8°, sextile/square/trine 5-6°
+- The potency of an aspect rises slowly as planets enter orb, accelerates toward exactitude, then declines. At 1/3 of orb distance = 1/4 potency; at 1/2 = 1/2 potency; at 2/3 = 3/4 potency.
+
+### The Planets That Matter Most for Business
+Jupiter, Uranus, and Saturn are the primary planets whose geometrical configurations affect the business cycle. Jupiter (11.86-year orbital period) correlates with the sunspot cycle. The synodical period of Jupiter-Uranus is 13.81 years; Jupiter-Saturn is 19.86 years; Saturn-Uranus is 45.36 years.
+
+---
+
+## The Planetary Cause of Sunspots
+
+### Historical Evidence
+- **1801**: Sir William Herschel first proposed that sunspot activity affected agricultural yields and prices.
+- **1859**: Rudolph Wolf devised a formula using planetary mass, distance, and angular position to produce a curve matching the sunspot curve.
+- **1863**: R. C. Carrington showed correlation between Jupiter's Radius Vector maxima and sunspot maxima from 1770 onward.
+- **1944**: G. E. Hale proved sunspots are powerful electromagnetic vortices. The true sunspot cycle is 22-23 years (twice the 11.11-year period, due to magnetic polarity reversal).
+
+### The Earth-Venus-Jupiter Tidal Wave
+Jose (1965) calculated solar surface tides from known planetary positions since 1750 and found close correlation between tidal ebb and flow and peak/quiescent sunspot activity. This provides a physical mechanism for planetary influence on solar activity.
+
+### Terrestrial Effects of Solar Activity
+Sunspot activity correlates with:
+- Agricultural yields and commodity prices
+- Rainfall and temperature patterns
+- Hurricane frequency (6-8 per year at maxima vs. 1-2 at minima)
+- Magnetic storms and radio transmission disruption
+- Human health and psychological states
+
+---
+
+## Planetary Cycles in Business and Markets
+
+### Jupiter Cycle (11.86 years)
+Jupiter is the largest planet and the primary driver of the sunspot cycle. Its major equinox occurs every 11.86 years. Benner found that pig iron price cycles of 1836, 1847, 1858, 1869 fell behind the Jovial cycle. Jupiter is considered the "ruling element in our price cycles of natural productions."
+
+### Venus Cycle (8 years)
+Moore's 8-year Venus cycle correlates with both business and sunspot cycles. Venus-Earth synodic period creates an 8-year rhythm that appears in commodity prices and stock market patterns.
+
+### Moon's Node Cycle (18.6 years)
+McWhirter's North Node business cycle: the Moon's North Node completes a full circle every 18.6 years. This creates a 4-year sub-cycle (90° increments) that correlates with market lows. The North Node in Leo (sign of speculation) in the 2nd house (money) of the NYSE chart is particularly significant.
+
+### Saturn Cycle (29.46 years)
+Saturn exerts influence regulating cycles in manufacture and trade. Its synodical period with Jupiter is 19.86 years. Saturn represents pessimism, contraction, and discipline in markets.
+
+### Uranus Cycle (84.02 years)
+Uranus, along with Neptune, "may send forth an electric influence affecting Jupiter, Saturn, and in turn, the earth." Uranus represents sudden change, innovation, and disruption.
+
+---
+
+## Benner's Price Cycles
+
+Samuel Benner (1875) developed the most notable forecast of prices in existence, with a 45:1 gain-loss ratio over 60 years. His key patterns:
+
+### Pig Iron Price Pattern
+- **Low-priced years**: decreasing series of 11, 9, 7 years (repeat every 27 years)
+- **High-priced years**: increasing series of 8, 9, 10 years (repeat every 27 years)
+- Depressions ("C") occur at 7-11-9 year intervals (average 9 years = Juglar cycle)
+- Panics ("A") occur at 16-18-20 year intervals, with every third peak at 54-year intervals (Kondratieff long wave)
+
+### Other Commodity Patterns
+- **Corn and Hogs**: 11-year cycle broken into alternate 5 and 6-year cycles (beginning 1836)
+- **Cotton**: follows an 11-year cycle
+- **General principle**: "When certain combinations are ascertained which produce one legitimate invariable manifestation from an analysis of the operations of the combined solar system, we may be enabled to discover the cause producing our price cycles."
+
+### Planetary Attribution
+- Jupiter: ruling element in price cycles of natural productions
+- Saturn: regulates cycles in manufacture and trade
+- Uranus and Neptune: send electric influence affecting Jupiter, Saturn, and Earth
+
+---
+
+## The 56-Year Pattern in American Business
+
+J. M. Funk's 1932 chart "The Cycles of Prosperity and Depression" revealed a 56-year pattern in American business activity. Williams added Jupiter, Saturn, and Uranus aspects to this chart for 1761-1958 and found a 68% correlation with business cycle movements.
+
+### Four Periods of the 56-Year Pattern
+1. **1761-1816**: First period
+2. **1817-1872**: Second period
+3. **1873-1928**: Third period
+4. **1929-1984**: Fourth period (predicted serious depression in 1985)
+
+The ups and downs of Jupiter-Saturn-Uranus planetary cycles showed 68% correlation with business cycle movements during 1761-1958.
+
+---
+
+## McWhirter's North Node Business Cycle
+
+W. D. McWhirter developed a stock market forecasting system based on the Moon's North Node:
+
+### Key Principles
+- The North Node's 18.6-year cycle creates a 4-year sub-cycle (quartering the circle)
+- Market lows correlate with the North Node at 0°, 90°, 180°, 270° of the zodiac
+- The North Node in Leo (speculation) in the 2nd house (money) of the NYSE chart is bullish
+- Favorable aspects from transiting planets to the North Node indicate rising markets
+- Unfavorable aspects indicate declining markets
+
+### McWhirter's NYSE Chart
+- **Date**: May 17, 1792, 8:52 a.m., New York City
+- Used for analyzing planetary aspects at each lunation (New Moon and Full Moon)
+- Aspects to natal NYSE planets indicate market direction for the following month
+
+---
+
+## The 9.2-Year Stock Market Cycle
+
+Edward R. Dewey identified a 9.2-year cycle in stock prices (1830-1966):
+- **Statistical significance**: Bartel's test shows this cycle could not occur by chance more than once in 5,000 times
+- **Tops**: correctly indicated 100% of the time
+- **Lows**: correctly indicated 12 out of 14 times (86%)
+- More precisely 9.225 years from crest to crest
+- This is similar to the 9-year Juglar cycle in business
+
+### Dewey's Recommendation
+Determine short-term cycles that have repeated so often they cannot be chance, then play them on an actuarial basis — expecting losses but expecting gains to exceed losses over the long run.
+
+---
+
+## The 38-41 Month Cycle
+
+### Discovery
+- **1912**: A New York group of investors discovered a 40.68-month cycle in industrial common stock prices (learned from Rothschild analysis of British Consols)
+- **1935**: Professor W. L. Crum (Harvard) noted a 39-40-41 month cycle in commercial paper rates
+- **1935**: Professor Kitchin (Harvard) discovered a 40-month cycle in six economic time series
+
+### Behavior
+- Worked with amazing correspondence from 1868-1945 (through wars, peace, good times, depression)
+- Reversed direction 1946-1956
+- Average length changed from 40.68 months to 38 months after 1932
+- When combined with the 9.2-year cycle: downward movements from tops correctly indicated 100% of the time; upward movements from lows 90% correct
+
+---
+
+## The Decennial Pattern
+
+A 10-year pattern in stock prices where certain years of the decade consistently show bullish or bearish tendencies. This pattern has been observed across multiple decades and is one of the oldest recognized stock market cycles.
+
+---
+
+## Williams' Solar Ingress Method
+
+Williams published quarterly stock market forecasts in Dell's Horoscope magazine from 1964-1982 with 80% average accuracy. His method:
+
+### Procedure
+1. Obtain the Solar Ingress chart for each quarter (Sun entering cardinal signs: Aries, Cancer, Libra, Capricorn). The forecast year begins with the Winter Solstice (Capricorn ingress, ~December 22).
+2. Calculate the degrees of separation between each pair of planets.
+3. Circle negative aspects in RED, positive aspects in GREEN.
+4. Use orbs: conjunction 10°, opposition 8°, sextile/square/trine 5°.
+5. Assign values: conjunctions 10, oppositions 8, trines 6, sextiles and squares 4.
+6. Add positive and negative values. The excess = Net Aspect Value.
+7. **Positive Net Aspect Value** = market UP for the next 3 months. **Negative** = market DOWN.
+
+### Converting Signs to Longitude
+| Sign | Degrees | Sign | Degrees |
+|------|---------|------|---------|
+| Aries | 0-30 | Libra | 180-210 |
+| Taurus | 30-60 | Scorpio | 210-240 |
+| Gemini | 60-90 | Sagittarius | 240-270 |
+| Cancer | 90-120 | Capricorn | 270-300 |
+| Leo | 120-150 | Aquarius | 300-330 |
+| Virgo | 150-180 | Pisces | 330-360 |
+
+### Conjunction Polarity
+Use Table 31 for conjunction polarity (which conjunctions are positive vs. negative based on the planets involved). Sextiles and trines are always positive. Squares and oppositions are always negative.
+
+### Location
+Washington, D.C. is used (not New York) because the federal government plays an increasing role in economic life.
+
+---
+
+## Williams' Running Total Aspect Method
+
+An alternative/complementary technique:
+
+### Procedure
+1. Start with a base value (e.g., 0 or the previous day's total).
+2. Each day, calculate all aspects between transiting planets and the natal planets of the NYSE chart (or a corporation's chart).
+3. Add positive aspect values and subtract negative aspect values.
+4. Plot the running total over time.
+5. **Preponderance of positive aspects at market highs** = time to SELL.
+6. **Preponderance of negative aspects at market lows** = time to BUY.
+
+### Key Insight
+There is a preponderance of positive aspects at market highs (when everyone is optimistic) and a preponderance of negative aspects at market lows (when everyone is pessimistic). The contrarian signal is the astrological signal.
+
+### Aspect Values
+- Only five major aspects considered: conjunction, sextile, square, trine, opposition
+- Minor aspects (30°, 45°, 135°, 150°) are omitted as they tend to offset each other
+- Transiting Moon is omitted (too fleeting)
+- Orb: 1.5° for all aspects between transiting and natal planets
+
+---
+
+## Corporation Horoscope Analysis
+
+Corporations are living entities whose lives begin at incorporation. Their horoscopes can be analyzed like natal charts.
+
+### Constructing a Corporation Chart
+1. Use the date of incorporation. If time is unknown, use a solar chart (Sun on Ascendant) with Equal House system and noon planetary positions.
+2. Calculate angular separation between each pair of planets.
+3. Mark negative aspects in RED, positive aspects in GREEN/BLUE.
+4. Orbs: conjunctions 10°, oppositions 8°, sextiles/squares/trines 5°.
+5. Determine aspects from transiting planets (Pluto through Mercury) to natal planets — these indicate when big up/down movements will occur.
+6. Always consider aspects to the company's ruler (planet ruling the sign the Sun is in).
+
+### Interpreting Corporation Charts
+- **Jupiter and Uranus** in favorable aspect to the Sun or chart ruler = upward trend
+- **Saturn** in favorable aspect = conservative growth, stability
+- **Neptune** = management's vision or liability to illusion/delusion
+- **Pluto** = mass production, mass consumption, mass psychology
+- **Mars** = energy, drive, potential for volatility
+- **Venus** = financial harmony, value
+
+### Stock Rulerships
+- Iron and steel: **Mars**
+- Copper: **Venus**
+- Oil: **Neptune**
+- Electric utilities: **Uranus**
+- Agriculture and real estate: **Saturn**
+- Underground mining: **Pluto**
+- Jupiter: optimism/expansion; Saturn: pessimism/contraction; Neptune: illusion/speculation
+
+---
+
+## Personal Investing — Natal Chart Indicators
+
+### Who Should Invest or Speculate
+1. **2nd house** (money from own efforts): Sun, Moon, Venus, or Jupiter in 2nd house or ruling the 2nd house cusp = success through conservative investment. Mars, Saturn, Uranus, Neptune, or Pluto = difficulties.
+2. **5th house** (speculation): Sun, Moon, Venus, Jupiter, or Neptune in 5th house or on its cusp = successful speculation. Mars, Saturn, Uranus, or Pluto = losses.
+3. **Afflicted Jupiter or Neptune in 5th house** = bad judgment from overoptimism.
+4. **Well-aspected Saturn in 5th house** = caution (good for conservative investors).
+5. **Conservative investors** often have Saturn in 2nd or 5th house — should use CDs or Money Market Funds.
+
+### The Formula for Picking Stocks
+"Buy only those stocks whose natal chart harmonizes with your own natal chart." (Advice from a retired VP of a major bank who went broke in 1929, then became a millionaire using astrology.)
+
+---
+
+## Which Stock to Buy
+
+### Practical Steps
+1. Determine your own natal chart's investment profile (2nd and 5th house analysis).
+2. Identify the corporation's natal chart (date of incorporation).
+3. Check for harmonious aspects between your natal planets and the corporation's natal planets.
+4. Analyze transiting aspects to the corporation's chart for timing.
+5. Look for favorable Jupiter and Uranus aspects to the company's Sun or ruler for upward price movement.
+6. Check for unfavorable Saturn, Mars, or Neptune aspects that might indicate decline.
+
+### Williams' Track Record
+Over 23 years of purchasing stocks for cash only, Williams achieved average annual gains of 25%.
+
+---
+
+## Gold and Silver Price Cycles
+
+### Gold
+- **22.11-year cycle** in U.S. gold prices (close to the 22-23 year sunspot cycle)
+- Peaks in gold prices correlate with peaks in sunspot activity
+- Gold is a traditional hedge against currency depreciation
+
+### Silver
+- Follows similar cyclical patterns to gold but with greater volatility
+- Industrial demand creates additional price drivers
+
+### Precious Metals and Planets
+- Astrologers disagree on which planets rule gold and silver
+- Traditional associations: Sun = gold, Moon = silver
+- Some practitioners use Saturn for gold (as the "heavy" metal)
+
+---
+
+## Interest Rate Cycles
+
+### The 54-Year Cycle
+The Foundation for the Study of Cycles identified a 54-year cycle in English interest rates (1729-1978), with an ideal high in 1978. There may also be a 60-year cycle at work.
+
+### Dewey's Prediction
+In 1957, Dewey concluded: "As far as our knowledge of cycles goes, the indication is for generally upward interest rates for the next 20 years."
+
+### Practical Implications
+- Rising interest rates = falling bond prices = headwinds for stocks
+- Falling interest rates = rising bond prices = tailwinds for stocks
+- The relationship between interest rates and stock prices is inverse
+
+---
+
+## The Kondratieff Wave
+
+### What It Is
+A 47-60 year cycle in economic activity identified by Russian economist N. D. Kondratieff (1919-21). Williams argues the popular "Prophets of Doom" interpretation is erroneous.
+
+### Williams' Critique
+- Shuman and Rosenau (1972) arbitrarily assumed a 50-year wavelength
+- They ignored Revolutionary War inflation (1780 peak)
+- They attempted prediction from only 2.5 cycles (insufficient data)
+- Actual cycle peaks: 34, 50, 56, 65 years (average 51.25 years)
+- The Kondratieff Wave is a useful framework but not a precise predictive tool
+
+### The Real Pattern
+The 56-year pattern (Funk's chart) combined with planetary aspects provides a more reliable framework than the Kondratieff Wave alone.
+
+---
+
+## Key Planetary Signatures for Markets
+
+### Bull Market Indicators
+- Stellium in Taurus (money sign) in the 11th house of the NYSE chart
+- Jupiter-Saturn conjunction sextile North Node in Leo (speculation) in 2nd house (money)
+- Mercury conjunct Venus and sextile Pluto
+- Sun and Moon sextile Uranus
+- Saturn semi-sextile Uranus and Mercury
+- Mercury and Uranus trine Neptune
+- Predominance of trines and sextiles in Solar Ingress charts
+
+### Bear Market Indicators
+- Sun and Moon opposition Neptune
+- Sun and Moon square Jupiter
+- Sun and Moon semi-square Saturn
+- Predominance of squares and oppositions in Solar Ingress charts
+- Transiting Saturn semi-square or sesquiquadrate natal Jupiter or Neptune
+
+### Market Tops
+- Preponderance of positive aspects (everyone optimistic)
+- Greed dominates — "the sky is the limit" mentality
+- Time to SELL
+
+### Market Bottoms
+- Preponderance of negative aspects (everyone pessimistic)
+- Fear dominates — "the bottom will fall out" mentality
+- Time to BUY
+
+### The NYSE Natal Chart
+- **May 17, 1792, 8:52 a.m., New York City**
+- Used as the basis for McWhirter-style analysis
+- Planetary positions at this date are the "natal" planets of the exchange
+
+---
+
+## Practical Rules and Heuristics
+
+### Williams' Rules
+1. **Buy during panics, sell during booms.** (Baron Rothschild's principle)
+2. **Don't get married to any stock.** (Don't get hung up on any one forecasting technique.)
+3. **Never gamble with more than you can afford to lose.**
+4. **Don't buy on margin.** Williams lost $620 over 22 years of margin trading.
+5. **Don't sell short.** Williams considers it unethical.
+6. **Don't trade stock options.** Most option traders lose money.
+7. **Don't trade interest rate futures.** The risk is too high.
+8. **Keep emotions under control.** Greed and fear are the two levers that control markets.
+9. **Use cash only.** Williams achieved 25% annual gains buying stocks for cash.
+10. **Verify with multiple methods.** Use Solar Ingress + Running Total Aspects + Corporation charts.
+
+### Dewey's Rules
+1. Determine short-term cycles that have repeated so often they cannot be chance.
+2. Play cycles on an actuarial basis — expect losses but expect gains to exceed losses.
+3. Use moving averages to smooth cycle data.
+4. Watch for compound cycles (e.g., 9.2-year and 38-month cycles combining).
+5. Be aware that cycles can reverse or disappear (the 5.7-year cycle vanished after 1896).
+
+### Benner's Rules
+1. Pig iron prices follow 11-9-7 year low patterns and 8-9-10 year high patterns.
+2. Panics occur at 16-18-20 year intervals.
+3. It takes 54 years for panics to complete a revolution and return in the same order.
+4. The iron industry is the chief indicator of general business conditions.
+
+### Gann's Principles (referenced by Williams)
+- Prices move in cycles that repeat.
+- The square of price and time are key relationships.
+- Support and resistance levels follow geometric patterns.
+
+---
+
+## Sources
+
+1. David Williams — *Financial Astrology: How To Forecast Business, and the Stock Market* (American Federation of Astrologers, 1982, 1984, 1988) ISBN: 0-86690-045-4
+2. David Williams — *Astro-Economics* (Llewellyn Publications, 1959)
+3. David Williams — *Business Cycle Forecasting* (Journal of Cycle Research, 1959)
+4. Edward R. Dewey & Edwin F. Dakin — *Cycles: The Science of Prediction* (1947)
+5. Edward R. Dewey — *Cycles: The Mysterious Forces that Trigger Events* (1971)
+6. Samuel Benner — *Benner's Prophecies of Future Ups and Downs in Prices* (1875, reprinted 1948)
+7. W. Stanley Jevons — "The Solar Period and the Price of Corn" (1875)
+8. W. D. Gann — *How to Make Profits in Commodities* (1942)
+9. N. D. Kondratieff — *The Long Waves in Economic Life* (1925)
+10. Foundation for the Study of Cycles — *Cycles* magazine (various issues)
+11. John H. Nelson — "Shortwave Radio Propagation Correlation and Planetary Positions" (RCA Review, 1951)
+12. R. C. Carrington — *Observations of the Spots on the Sun* (1863)
+13. Rudolph Wolf — Sunspot number formula (1852)
+14. Jose, P. D. — "Sun's Motion and Sunspots" (Astronomical Journal, 1965)
+15. W. D. McWhirter — Stock market forecasting system (various publications)

+ 433 - 0
financial-astrology.md

@@ -0,0 +1,433 @@
+# Financial Astrology — A Compiled Reference
+
+> Compiled from David Williams' *Financial Astrology: How To Forecast Business, and the Stock Market* (American Federation of Astrologers, 1982, 1984, 1988).
+> Additional sources: Edward R. Dewey's *Cycles: The Science of Prediction* (1947), Samuel Benner's *Prophecies of Future Ups and Downs in Prices* (1875), W. D. Gann, N. D. Kondratieff, and various cycle researchers.
+
+---
+
+## Table of Contents
+
+1. [Core Principles](#core-principles)
+2. [The Planetary Cause of Sunspots](#the-planetary-cause-of-sunspots)
+3. [Planetary Cycles in Business and Markets](#planetary-cycles-in-business-and-markets)
+4. [Benner's Price Cycles](#benners-price-cycles)
+5. [The 56-Year Pattern in American Business](#the-56-year-pattern-in-american-business)
+6. [McWhirter's North Node Business Cycle](#mcwhirters-north-node-business-cycle)
+7. [The 9.2-Year Stock Market Cycle](#the-92-year-stock-market-cycle)
+8. [The 38-41 Month Cycle](#the-38-41-month-cycle)
+9. [The Decennial Pattern](#the-decennial-pattern)
+10. [Williams' Solar Ingress Method](#williams-solar-ingress-method)
+11. [Williams' Running Total Aspect Method](#williams-running-total-aspect-method)
+12. [Corporation Horoscope Analysis](#corporation-horoscope-analysis)
+13. [Personal Investing — Natal Chart Indicators](#personal-investing--natal-chart-indicators)
+14. [Which Stock to Buy](#which-stock-to-buy)
+15. [Gold and Silver Price Cycles](#gold-and-silver-price-cycles)
+16. [Interest Rate Cycles](#interest-rate-cycles)
+17. [The Kondratieff Wave](#the-kondratieff-wave)
+18. [Key Planetary Signatures for Markets](#key-planetary-signatures-for-markets)
+19. [Practical Rules and Heuristics](#practical-rules-and-heuristics)
+20. [Sources](#sources)
+
+---
+
+## Core Principles
+
+### The Law of Causality
+Everything that happens is the consequence of a previous state of things. Economic forecasting is predicated upon adequate knowledge of existing conditions. The Law of Periodical Repetition states that everything which has happened once must happen again — not capriciously, but at regular periods.
+
+### The Mental Mood Theory
+Business cycles begin and end in the minds of men. Nervousness about business prospects translates quickly into lower economic activity. Economics and psychology go hand in hand. As Jung stated: "Astrology represents the summation of all the psychological knowledge of Antiquity."
+
+### The Electromagnetic Hypothesis
+At the moment of birth, the resultant magnetic field of the Sun, Moon, and planets produces a type of sensitivity and selectivity in the individual. When a transiting planet re-enters the area of the natal planet, magnetic effects are produced that operate as a cause affecting the individual. Each planet radiates astral energy of a different frequency. The angles (aspects) between planets determine whether energies combine into harmony or discord.
+
+### Aspect Polarities
+- **Harmonious aspects**: 60° (sextile), 120° (trine) — favorable conditions
+- **Inharmonious aspects**: 0° (conjunction), 90° (square), 180° (opposition) — unfavorable conditions
+- **Orbs of influence**: conjunction 10°, opposition 8°, sextile/square/trine 5-6°
+- The potency of an aspect rises slowly as planets enter orb, accelerates toward exactitude, then declines. At 1/3 of orb distance = 1/4 potency; at 1/2 = 1/2 potency; at 2/3 = 3/4 potency.
+
+### The Planets That Matter Most for Business
+Jupiter, Uranus, and Saturn are the primary planets whose geometrical configurations affect the business cycle. Jupiter (11.86-year orbital period) correlates with the sunspot cycle. The synodical period of Jupiter-Uranus is 13.81 years; Jupiter-Saturn is 19.86 years; Saturn-Uranus is 45.36 years.
+
+---
+
+## The Planetary Cause of Sunspots
+
+### Historical Evidence
+- **1801**: Sir William Herschel first proposed that sunspot activity affected agricultural yields and prices.
+- **1859**: Rudolph Wolf devised a formula using planetary mass, distance, and angular position to produce a curve matching the sunspot curve.
+- **1863**: R. C. Carrington showed correlation between Jupiter's Radius Vector maxima and sunspot maxima from 1770 onward.
+- **1944**: G. E. Hale proved sunspots are powerful electromagnetic vortices. The true sunspot cycle is 22-23 years (twice the 11.11-year period, due to magnetic polarity reversal).
+
+### The Earth-Venus-Jupiter Tidal Wave
+Jose (1965) calculated solar surface tides from known planetary positions since 1750 and found close correlation between tidal ebb and flow and peak/quiescent sunspot activity. This provides a physical mechanism for planetary influence on solar activity.
+
+### Terrestrial Effects of Solar Activity
+Sunspot activity correlates with:
+- Agricultural yields and commodity prices
+- Rainfall and temperature patterns
+- Hurricane frequency (6-8 per year at maxima vs. 1-2 at minima)
+- Magnetic storms and radio transmission disruption
+- Human health and psychological states
+
+---
+
+## Planetary Cycles in Business and Markets
+
+### Jupiter Cycle (11.86 years)
+Jupiter is the largest planet and the primary driver of the sunspot cycle. Its major equinox occurs every 11.86 years. Benner found that pig iron price cycles of 1836, 1847, 1858, 1869 fell behind the Jovial cycle. Jupiter is considered the "ruling element in our price cycles of natural productions."
+
+### Venus Cycle (8 years)
+Moore's 8-year Venus cycle correlates with both business and sunspot cycles. Venus-Earth synodic period creates an 8-year rhythm that appears in commodity prices and stock market patterns.
+
+### Moon's Node Cycle (18.6 years)
+McWhirter's North Node business cycle: the Moon's North Node completes a full circle every 18.6 years. This creates a 4-year sub-cycle (90° increments) that correlates with market lows. The North Node in Leo (sign of speculation) in the 2nd house (money) of the NYSE chart is particularly significant.
+
+### Saturn Cycle (29.46 years)
+Saturn exerts influence regulating cycles in manufacture and trade. Its synodical period with Jupiter is 19.86 years. Saturn represents pessimism, contraction, and discipline in markets.
+
+### Uranus Cycle (84.02 years)
+Uranus, along with Neptune, "may send forth an electric influence affecting Jupiter, Saturn, and in turn, the earth." Uranus represents sudden change, innovation, and disruption.
+
+---
+
+## Benner's Price Cycles
+
+Samuel Benner (1875) developed the most notable forecast of prices in existence, with a 45:1 gain-loss ratio over 60 years. His key patterns:
+
+### Pig Iron Price Pattern
+- **Low-priced years**: decreasing series of 11, 9, 7 years (repeat every 27 years)
+- **High-priced years**: increasing series of 8, 9, 10 years (repeat every 27 years)
+- Depressions ("C") occur at 7-11-9 year intervals (average 9 years = Juglar cycle)
+- Panics ("A") occur at 16-18-20 year intervals, with every third peak at 54-year intervals (Kondratieff long wave)
+
+### Other Commodity Patterns
+- **Corn and Hogs**: 11-year cycle broken into alternate 5 and 6-year cycles (beginning 1836)
+- **Cotton**: follows an 11-year cycle
+- **General principle**: "When certain combinations are ascertained which produce one legitimate invariable manifestation from an analysis of the operations of the combined solar system, we may be enabled to discover the cause producing our price cycles."
+
+### Planetary Attribution
+- Jupiter: ruling element in price cycles of natural productions
+- Saturn: regulates cycles in manufacture and trade
+- Uranus and Neptune: send electric influence affecting Jupiter, Saturn, and Earth
+
+---
+
+## The 56-Year Pattern in American Business
+
+J. M. Funk's 1932 chart "The Cycles of Prosperity and Depression" revealed a 56-year pattern in American business activity. Williams added Jupiter, Saturn, and Uranus aspects to this chart for 1761-1958 and found a 68% correlation with business cycle movements.
+
+### Four Periods of the 56-Year Pattern
+1. **1761-1816**: First period
+2. **1817-1872**: Second period
+3. **1873-1928**: Third period
+4. **1929-1984**: Fourth period (predicted serious depression in 1985)
+
+The ups and downs of Jupiter-Saturn-Uranus planetary cycles showed 68% correlation with business cycle movements during 1761-1958.
+
+---
+
+## McWhirter's North Node Business Cycle
+
+W. D. McWhirter developed a stock market forecasting system based on the Moon's North Node:
+
+### Key Principles
+- The North Node's 18.6-year cycle creates a 4-year sub-cycle (quartering the circle)
+- Market lows correlate with the North Node at 0°, 90°, 180°, 270° of the zodiac
+- The North Node in Leo (speculation) in the 2nd house (money) of the NYSE chart is bullish
+- Favorable aspects from transiting planets to the North Node indicate rising markets
+- Unfavorable aspects indicate declining markets
+
+### McWhirter's NYSE Chart
+- **Date**: May 17, 1792, 8:52 a.m., New York City
+- Used for analyzing planetary aspects at each lunation (New Moon and Full Moon)
+- Aspects to natal NYSE planets indicate market direction for the following month
+
+---
+
+## The 9.2-Year Stock Market Cycle
+
+Edward R. Dewey identified a 9.2-year cycle in stock prices (1830-1966):
+- **Statistical significance**: Bartel's test shows this cycle could not occur by chance more than once in 5,000 times
+- **Tops**: correctly indicated 100% of the time
+- **Lows**: correctly indicated 12 out of 14 times (86%)
+- More precisely 9.225 years from crest to crest
+- This is similar to the 9-year Juglar cycle in business
+
+### Dewey's Recommendation
+Determine short-term cycles that have repeated so often they cannot be chance, then play them on an actuarial basis — expecting losses but expecting gains to exceed losses over the long run.
+
+---
+
+## The 38-41 Month Cycle
+
+### Discovery
+- **1912**: A New York group of investors discovered a 40.68-month cycle in industrial common stock prices (learned from Rothschild analysis of British Consols)
+- **1935**: Professor W. L. Crum (Harvard) noted a 39-40-41 month cycle in commercial paper rates
+- **1935**: Professor Kitchin (Harvard) discovered a 40-month cycle in six economic time series
+
+### Behavior
+- Worked with amazing correspondence from 1868-1945 (through wars, peace, good times, depression)
+- Reversed direction 1946-1956
+- Average length changed from 40.68 months to 38 months after 1932
+- When combined with the 9.2-year cycle: downward movements from tops correctly indicated 100% of the time; upward movements from lows 90% correct
+
+---
+
+## The Decennial Pattern
+
+A 10-year pattern in stock prices where certain years of the decade consistently show bullish or bearish tendencies. This pattern has been observed across multiple decades and is one of the oldest recognized stock market cycles.
+
+---
+
+## Williams' Solar Ingress Method
+
+Williams published quarterly stock market forecasts in Dell's Horoscope magazine from 1964-1982 with 80% average accuracy. His method:
+
+### Procedure
+1. Obtain the Solar Ingress chart for each quarter (Sun entering cardinal signs: Aries, Cancer, Libra, Capricorn). The forecast year begins with the Winter Solstice (Capricorn ingress, ~December 22).
+2. Calculate the degrees of separation between each pair of planets.
+3. Circle negative aspects in RED, positive aspects in GREEN.
+4. Use orbs: conjunction 10°, opposition 8°, sextile/square/trine 5°.
+5. Assign values: conjunctions 10, oppositions 8, trines 6, sextiles and squares 4.
+6. Add positive and negative values. The excess = Net Aspect Value.
+7. **Positive Net Aspect Value** = market UP for the next 3 months. **Negative** = market DOWN.
+
+### Converting Signs to Longitude
+| Sign | Degrees | Sign | Degrees |
+|------|---------|------|---------|
+| Aries | 0-30 | Libra | 180-210 |
+| Taurus | 30-60 | Scorpio | 210-240 |
+| Gemini | 60-90 | Sagittarius | 240-270 |
+| Cancer | 90-120 | Capricorn | 270-300 |
+| Leo | 120-150 | Aquarius | 300-330 |
+| Virgo | 150-180 | Pisces | 330-360 |
+
+### Conjunction Polarity
+Use Table 31 for conjunction polarity (which conjunctions are positive vs. negative based on the planets involved). Sextiles and trines are always positive. Squares and oppositions are always negative.
+
+### Location
+Washington, D.C. is used (not New York) because the federal government plays an increasing role in economic life.
+
+---
+
+## Williams' Running Total Aspect Method
+
+An alternative/complementary technique:
+
+### Procedure
+1. Start with a base value (e.g., 0 or the previous day's total).
+2. Each day, calculate all aspects between transiting planets and the natal planets of the NYSE chart (or a corporation's chart).
+3. Add positive aspect values and subtract negative aspect values.
+4. Plot the running total over time.
+5. **Preponderance of positive aspects at market highs** = time to SELL.
+6. **Preponderance of negative aspects at market lows** = time to BUY.
+
+### Key Insight
+There is a preponderance of positive aspects at market highs (when everyone is optimistic) and a preponderance of negative aspects at market lows (when everyone is pessimistic). The contrarian signal is the astrological signal.
+
+### Aspect Values
+- Only five major aspects considered: conjunction, sextile, square, trine, opposition
+- Minor aspects (30°, 45°, 135°, 150°) are omitted as they tend to offset each other
+- Transiting Moon is omitted (too fleeting)
+- Orb: 1.5° for all aspects between transiting and natal planets
+
+---
+
+## Corporation Horoscope Analysis
+
+Corporations are living entities whose lives begin at incorporation. Their horoscopes can be analyzed like natal charts.
+
+### Constructing a Corporation Chart
+1. Use the date of incorporation. If time is unknown, use a solar chart (Sun on Ascendant) with Equal House system and noon planetary positions.
+2. Calculate angular separation between each pair of planets.
+3. Mark negative aspects in RED, positive aspects in GREEN/BLUE.
+4. Orbs: conjunctions 10°, oppositions 8°, sextiles/squares/trines 5°.
+5. Determine aspects from transiting planets (Pluto through Mercury) to natal planets — these indicate when big up/down movements will occur.
+6. Always consider aspects to the company's ruler (planet ruling the sign the Sun is in).
+
+### Interpreting Corporation Charts
+- **Jupiter and Uranus** in favorable aspect to the Sun or chart ruler = upward trend
+- **Saturn** in favorable aspect = conservative growth, stability
+- **Neptune** = management's vision or liability to illusion/delusion
+- **Pluto** = mass production, mass consumption, mass psychology
+- **Mars** = energy, drive, potential for volatility
+- **Venus** = financial harmony, value
+
+### Stock Rulerships
+- Iron and steel: **Mars**
+- Copper: **Venus**
+- Oil: **Neptune**
+- Electric utilities: **Uranus**
+- Agriculture and real estate: **Saturn**
+- Underground mining: **Pluto**
+- Jupiter: optimism/expansion; Saturn: pessimism/contraction; Neptune: illusion/speculation
+
+---
+
+## Personal Investing — Natal Chart Indicators
+
+### Who Should Invest or Speculate
+1. **2nd house** (money from own efforts): Sun, Moon, Venus, or Jupiter in 2nd house or ruling the 2nd house cusp = success through conservative investment. Mars, Saturn, Uranus, Neptune, or Pluto = difficulties.
+2. **5th house** (speculation): Sun, Moon, Venus, Jupiter, or Neptune in 5th house or on its cusp = successful speculation. Mars, Saturn, Uranus, or Pluto = losses.
+3. **Afflicted Jupiter or Neptune in 5th house** = bad judgment from overoptimism.
+4. **Well-aspected Saturn in 5th house** = caution (good for conservative investors).
+5. **Conservative investors** often have Saturn in 2nd or 5th house — should use CDs or Money Market Funds.
+
+### The Formula for Picking Stocks
+"Buy only those stocks whose natal chart harmonizes with your own natal chart." (Advice from a retired VP of a major bank who went broke in 1929, then became a millionaire using astrology.)
+
+---
+
+## Which Stock to Buy
+
+### Practical Steps
+1. Determine your own natal chart's investment profile (2nd and 5th house analysis).
+2. Identify the corporation's natal chart (date of incorporation).
+3. Check for harmonious aspects between your natal planets and the corporation's natal planets.
+4. Analyze transiting aspects to the corporation's chart for timing.
+5. Look for favorable Jupiter and Uranus aspects to the company's Sun or ruler for upward price movement.
+6. Check for unfavorable Saturn, Mars, or Neptune aspects that might indicate decline.
+
+### Williams' Track Record
+Over 23 years of purchasing stocks for cash only, Williams achieved average annual gains of 25%.
+
+---
+
+## Gold and Silver Price Cycles
+
+### Gold
+- **22.11-year cycle** in U.S. gold prices (close to the 22-23 year sunspot cycle)
+- Peaks in gold prices correlate with peaks in sunspot activity
+- Gold is a traditional hedge against currency depreciation
+
+### Silver
+- Follows similar cyclical patterns to gold but with greater volatility
+- Industrial demand creates additional price drivers
+
+### Precious Metals and Planets
+- Astrologers disagree on which planets rule gold and silver
+- Traditional associations: Sun = gold, Moon = silver
+- Some practitioners use Saturn for gold (as the "heavy" metal)
+
+---
+
+## Interest Rate Cycles
+
+### The 54-Year Cycle
+The Foundation for the Study of Cycles identified a 54-year cycle in English interest rates (1729-1978), with an ideal high in 1978. There may also be a 60-year cycle at work.
+
+### Dewey's Prediction
+In 1957, Dewey concluded: "As far as our knowledge of cycles goes, the indication is for generally upward interest rates for the next 20 years."
+
+### Practical Implications
+- Rising interest rates = falling bond prices = headwinds for stocks
+- Falling interest rates = rising bond prices = tailwinds for stocks
+- The relationship between interest rates and stock prices is inverse
+
+---
+
+## The Kondratieff Wave
+
+### What It Is
+A 47-60 year cycle in economic activity identified by Russian economist N. D. Kondratieff (1919-21). Williams argues the popular "Prophets of Doom" interpretation is erroneous.
+
+### Williams' Critique
+- Shuman and Rosenau (1972) arbitrarily assumed a 50-year wavelength
+- They ignored Revolutionary War inflation (1780 peak)
+- They attempted prediction from only 2.5 cycles (insufficient data)
+- Actual cycle peaks: 34, 50, 56, 65 years (average 51.25 years)
+- The Kondratieff Wave is a useful framework but not a precise predictive tool
+
+### The Real Pattern
+The 56-year pattern (Funk's chart) combined with planetary aspects provides a more reliable framework than the Kondratieff Wave alone.
+
+---
+
+## Key Planetary Signatures for Markets
+
+### Bull Market Indicators
+- Stellium in Taurus (money sign) in the 11th house of the NYSE chart
+- Jupiter-Saturn conjunction sextile North Node in Leo (speculation) in 2nd house (money)
+- Mercury conjunct Venus and sextile Pluto
+- Sun and Moon sextile Uranus
+- Saturn semi-sextile Uranus and Mercury
+- Mercury and Uranus trine Neptune
+- Predominance of trines and sextiles in Solar Ingress charts
+
+### Bear Market Indicators
+- Sun and Moon opposition Neptune
+- Sun and Moon square Jupiter
+- Sun and Moon semi-square Saturn
+- Predominance of squares and oppositions in Solar Ingress charts
+- Transiting Saturn semi-square or sesquiquadrate natal Jupiter or Neptune
+
+### Market Tops
+- Preponderance of positive aspects (everyone optimistic)
+- Greed dominates — "the sky is the limit" mentality
+- Time to SELL
+
+### Market Bottoms
+- Preponderance of negative aspects (everyone pessimistic)
+- Fear dominates — "the bottom will fall out" mentality
+- Time to BUY
+
+### The NYSE Natal Chart
+- **May 17, 1792, 8:52 a.m., New York City**
+- Used as the basis for McWhirter-style analysis
+- Planetary positions at this date are the "natal" planets of the exchange
+
+---
+
+## Practical Rules and Heuristics
+
+### Williams' Rules
+1. **Buy during panics, sell during booms.** (Baron Rothschild's principle)
+2. **Don't get married to any stock.** (Don't get hung up on any one forecasting technique.)
+3. **Never gamble with more than you can afford to lose.**
+4. **Don't buy on margin.** Williams lost $620 over 22 years of margin trading.
+5. **Don't sell short.** Williams considers it unethical.
+6. **Don't trade stock options.** Most option traders lose money.
+7. **Don't trade interest rate futures.** The risk is too high.
+8. **Keep emotions under control.** Greed and fear are the two levers that control markets.
+9. **Use cash only.** Williams achieved 25% annual gains buying stocks for cash.
+10. **Verify with multiple methods.** Use Solar Ingress + Running Total Aspects + Corporation charts.
+
+### Dewey's Rules
+1. Determine short-term cycles that have repeated so often they cannot be chance.
+2. Play cycles on an actuarial basis — expect losses but expect gains to exceed losses.
+3. Use moving averages to smooth cycle data.
+4. Watch for compound cycles (e.g., 9.2-year and 38-month cycles combining).
+5. Be aware that cycles can reverse or disappear (the 5.7-year cycle vanished after 1896).
+
+### Benner's Rules
+1. Pig iron prices follow 11-9-7 year low patterns and 8-9-10 year high patterns.
+2. Panics occur at 16-18-20 year intervals.
+3. It takes 54 years for panics to complete a revolution and return in the same order.
+4. The iron industry is the chief indicator of general business conditions.
+
+### Gann's Principles (referenced by Williams)
+- Prices move in cycles that repeat.
+- The square of price and time are key relationships.
+- Support and resistance levels follow geometric patterns.
+
+---
+
+## Sources
+
+1. David Williams — *Financial Astrology: How To Forecast Business, and the Stock Market* (American Federation of Astrologers, 1982, 1984, 1988) ISBN: 0-86690-045-4
+2. David Williams — *Astro-Economics* (Llewellyn Publications, 1959)
+3. David Williams — *Business Cycle Forecasting* (Journal of Cycle Research, 1959)
+4. Edward R. Dewey & Edwin F. Dakin — *Cycles: The Science of Prediction* (1947)
+5. Edward R. Dewey — *Cycles: The Mysterious Forces that Trigger Events* (1971)
+6. Samuel Benner — *Benner's Prophecies of Future Ups and Downs in Prices* (1875, reprinted 1948)
+7. W. Stanley Jevons — "The Solar Period and the Price of Corn" (1875)
+8. W. D. Gann — *How to Make Profits in Commodities* (1942)
+9. N. D. Kondratieff — *The Long Waves in Economic Life* (1925)
+10. Foundation for the Study of Cycles — *Cycles* magazine (various issues)
+11. John H. Nelson — "Shortwave Radio Propagation Correlation and Planetary Positions" (RCA Review, 1951)
+12. R. C. Carrington — *Observations of the Spots on the Sun* (1863)
+13. Rudolph Wolf — Sunspot number formula (1852)
+14. Jose, P. D. — "Sun's Motion and Sunspots" (Astronomical Journal, 1965)
+15. W. D. McWhirter — Stock market forecasting system (various publications)

+ 6 - 0
src/astro_mcp/server.py

@@ -81,6 +81,12 @@ def relationship_astrology_guide() -> str:
     return _read_guide("relationship-astrology.md")
 
 
+@mcp.resource("astro://guides/financial-astrology")
+def financial_astrology_guide() -> str:
+    """Agent interpretation guide for financial astrology — business cycles, stock market forecasting, planetary correlations."""
+    return _read_guide("financial-astrology.md")
+
+
 def create_app() -> FastAPI:
     config.LOG_DIR.mkdir(parents=True, exist_ok=True)
     logging.basicConfig(

+ 6 - 2
src/astro_mcp/tools.py

@@ -315,7 +315,9 @@ Shows how current (or future) transiting planets aspect the natal chart. Useful
 identifying active transit windows and their themes. For daily transit snapshots,
 use get_transit_preview instead.
 
-For interpretation guidance, fetch resource: astro://guides/natal-astrology
+For interpretation guidance, fetch resources:
+- astro://guides/natal-astrology
+- astro://guides/financial-astrology (for market-timing and economic cycle analysis)
 
 Args:
     birth_datetime: ISO 8601 birth datetime (UTC).
@@ -704,7 +706,9 @@ score (0-10) based on aspect type, planet importance, and orb tightness.
 Use this for identifying active transit windows and forecasting themes. For a single
 transit moment, use calculate_transit_chart instead.
 
-For interpretation guidance, fetch resource: astro://guides/natal-astrology
+For interpretation guidance, fetch resources:
+- astro://guides/natal-astrology
+- astro://guides/financial-astrology (for market-timing and economic cycle analysis)
 
 Args:
     birth_datetime: ISO 8601 birth datetime (UTC).