pondlog

open-source nature data, aggregated

What’s happening
outside?

$ pondlog today --location "Port Angeles, WA" 

      


      

        

          $
          npm install -g pondlog
          
        

        

          or npx @pondlog/mcp-pondlog  one MCP, all data
        

      

    


    
    

      

        $ pondlog mcp --list
      

      

        Six servers on the official MCP Registry. Install any of them with one command.
      


      

        

          

            
pondlog

            unified briefing
          

          npx @pondlog/mcp-pondlog
          
5 tools · all 8 sources in one call · v0.4.0

          
        


        

          

            
ebird

            definitive · 100% api
          

          npx @pondlog/mcp-ebird
          
21 tools · full eBird API v2 · v0.1.5

          
        


        

          

            
inaturalist

            first
          

          npx @pondlog/mcp-inaturalist
          
9 tools · all wildlife taxa · v0.1.3

          
        


        

          

            
npn

            first
          

          npx @pondlog/mcp-npn
          
8 tools · USA-NPN phenology · v0.1.5

          
        


        

          

            
usgs

            first
          

          npx @pondlog/mcp-usgs
          
4 tools · streamflow + gage height · v0.1.6

          
        


        

          

            
mushroomobserver

            first
          

          npx @pondlog/mcp-mushroomobserver
          
5 tools · mycology observations · v0.1.5

          
        


      


      

        All six registered on the
        official MCP Registry.
        The first iNaturalist MCP. The first phenology MCP.
        The first mycology MCP. The first streamflow MCP.
        The first unified nature briefing.
        The definitive eBird MCP with 100% API coverage.
      


      
    


    
    

      

        $ pondlog today --verbose
      

      

        The receipt. Every line in the hero, expanded.
      


      

        

          
          
          
          ~/pondlog
        


location: Port Angeles, WA  (48.118, -123.431)
date:     2026-05-12

🦅 BIRDS (eBird)
   12 species near hotspot Ediz Hook this week
   notable: Marbled Murrelet (2 sightings, May 9)
   yard-bird density within 5km: 47 reports

🌿 WILDLIFE (iNaturalist)
   47 observations within 25km, past 7 days
   recent: Pacific Tree Frog · Coast Garter Snake · Black-tailed Deer
   research-grade rate: 64%

🍄 FUNGI (Mushroom Observer)
   3 recent observations
   most recent: Cantharellus formosus, May 8 (Elwha Valley)

🌊 TIDES (NOAA · station 9444090)
   high  04:32 PT   6.2 ft
   low   10:47 PT   1.1 ft
   high  16:58 PT   7.4 ft
   low   23:14 PT   0.4 ft

💧 STREAMFLOW (USGS · gage 12045500)
   Elwha River at McDonald Bridge
   current 342 cfs · 7-day avg 318 cfs · status normal

🌙 NIGHT SKY (astronomy-engine · local)
   moon:   waxing gibbous · 82% illuminated
   rises:  18:24 PT      sets: 04:31 PT
   sun:    rise 05:39    set  20:48
   planets visible: Venus (W, dusk) · Jupiter (E, predawn)

🌸 PHENOLOGY (USA-NPN)
   3 active species nearby in the past 14 days
   Red flowering currant: first bloom
   Pacific dogwood: leaf out
   Bigleaf maple: flower

🌱 GARDEN (live · cropgraph)
   zone:     8b
   climate:  maritime
   season:   260 days
   plant now: bush bean (direct sow) · cucumber (transplant) ·
              kale (direct sow) · cilantro (direct sow)
   companions surfaced: basil ↔ tomato · nasturtium ↔ cucumber

────────────────────────────────────────────────────────────
8 sources · 1 call · 0 keys required for 6 of 8

      

    


    
    

      

        $ pondlog config show --sources
      

      

        Eight sources, each wrapped in a typed client library. Auth requirements and rate limits up front, no surprises.
      


      

        

          
iNaturalist

          

            
data
wildlife observations · all taxa

            
auth
none

            
rate-limit
100 / min

            
package
@pondlog/source-inaturalist

            
functions
9

          

        


        

          
eBird

          

            
data
bird sightings · hotspots · taxonomy

            
auth
EBIRD_API_KEY (free)

            
rate-limit
100 / min

            
package
@pondlog/source-ebird

            
functions
21

          

        


        

          
USA-NPN

          

            
data
phenology · bloom · leaf-out · flight

            
auth
none

            
rate-limit
1 / sec

            
package
@pondlog/source-npn

            
functions
7

          

        


        

          
USGS Water

          

            
data
streamflow · gage height

            
auth
none

            
rate-limit
1 / sec

            
package
@pondlog/source-usgs

            
functions
4

          

        


        

          
NOAA CO-OPS

          

            
data
tide predictions · water levels

            
auth
none

            
rate-limit
5 / sec

            
package
bundled in @pondlog/core

            
functions
3

          

        


        

          
Mushroom Observer

          

            
data
mycology observations · names

            
auth
none

            
rate-limit
20 / min

            
package
@pondlog/source-mushroomobserver

            
functions
7

          

        


        

          
astronomy-engine

          

            
data
moon · sun · planets · meteors · constellations

            
auth
none · local

            
rate-limit
n / a

            
package
@pondlog/source-nightsky

            
functions
7

          

        


        

          
Trefle

          

            
data
plant taxonomy · sun · pH · light

            
auth
API token (free)

            
rate-limit
60 / min

            
package
@pondlog/source-trefle

            
functions
varies

          

        


        

          
CropGraph

          

            
data
garden planning · planting calendar · companion graph

            
auth
none · bundled data

            
rate-limit
n / a · local computation

            
package
@cropgraph/core

            
functions
12+

          

        

      

    


    
    

      

        $ pondlog --architecture
      

      

        Source clients feed a typed core. The CLI and six MCP servers are thin wrappers on top.
      


      

        

          
          
          
          packages/
        


    sources                   core                clients
─────────────────────    ───────────────────    ─────────────────────

    iNaturalist  ───┐                            ┌── @pondlog/cli
    eBird        ───┤                            │      pondlog today
    NPN          ───┤                            │
    USGS         ───┼──► @pondlog/core  ────────┤   @pondlog/mcp-*
    NOAA tides   ───┤    • zod types             │      6 servers
    Mushroom Obs ───┤    • rate-limiter          │      all registered
    astronomy    ───┤    • result<T>             │
    Trefle       ───┘    • NOAA tides            └── your app
                                                     your agent
                                                     your kiosk

    external

    @cropgraph/core  ──►  @pondlog/mcp-pondlog
       (garden data)        (aggregate briefing)


      

    


    
    

      

        $ pondlog --stats
      


      

        

          
          
          
          today
        


data-sources:         8
mcp-servers:          6     (5 first-of-their-kind on the registry)
cli-commands:         25+
npm-packages:         15
tests-passing:        150+
competitors:          0     (for 5 of 6 MCPs)
garden-data:          via @cropgraph/core
days-to-build:        3

      

    


    
    

      

        $ cat docs/CONTRIBUTING.md
      

      

        Eight sources, six MCPs, one CLI. Source clients, MCP tools, and CLI commands all live in github.com/andrewschristison/pondlog. Open an issue or a PR.
      

      

        The crop calendar and companion graph are maintained by CropGraph. Garden-data contributions belong at github.com/Cropgraph/cropgraph, not in pondlog.
      


      

        

          
          
          
          packages/
        


$ git clone https://github.com/andrewschristison/pondlog
$ pnpm install
$ pnpm -r test

// add a new source: clone an existing source-* package as a template
$ cp -r packages/source-inaturalist packages/source-yoursource

// add a new MCP tool: edit the relevant mcp-* package's tools.ts
$ $EDITOR packages/mcp-inaturalist/src/tools.ts

// crop calendar / companion graph contributions go to cropgraph
$ open https://github.com/Cropgraph/cropgraph

      


      

        pondlog on github →
        cropgraph on github →
        open an issue →