protogrid

Search / io.github.thirdtrail/thirdtrail

thirdtrail

R1· needs a key

Elevation-corrected sun, moon, twilight, solar and tide data for any point on Earth

v1.0.0 · active · repository · website · descriptor JSON · versions

An agent can connect on its own if it already holds THIRDTRAIL_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality84good
Trust96of 100
Uptime, 30 days91%
Latency p50506 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "thirdtrail": {
      "type": "http",
      "url": "https://thirdtrail.life/mcp",
      "headers": {
        "Authorization": "Bearer ${THIRDTRAIL_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http thirdtrail https://thirdtrail.life/mcp --header "Authorization: Bearer ${THIRDTRAIL_TOKEN}"
[mcp_servers.thirdtrail]
url = "https://thirdtrail.life/mcp"
bearer_token_env_var = "THIRDTRAIL_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "thirdtrail": {
      "type": "remote",
      "url": "https://thirdtrail.life/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:THIRDTRAIL_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "thirdtrail": {
      "type": "http",
      "url": "https://thirdtrail.life/mcp",
      "headers": {
        "Authorization": "Bearer ${THIRDTRAIL_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=thirdtrail&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vdGhpcmR0cmFpbC5saWZlL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke1RISVJEVFJBSUxfVE9LRU59In19"
}
{
  "servers": {
    "thirdtrail": {
      "type": "http",
      "url": "https://thirdtrail.life/mcp",
      "headers": {
        "Authorization": "Bearer ${THIRDTRAIL_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "thirdtrail": {
      "httpUrl": "https://thirdtrail.life/mcp",
      "headers": {
        "Authorization": "Bearer ${THIRDTRAIL_TOKEN}"
      }
    }
  }
}
extensions:
  "thirdtrail":
    enabled: true
    name: "thirdtrail"
    type: streamable_http
    uri: "https://thirdtrail.life/mcp"
    headers:
      "Authorization": "Bearer ${THIRDTRAIL_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${THIRDTRAIL_TOKEN}. The registry never accepts secret values.

Quality 84 / 100good

protocol100 · weight 25
  • pass
    protocol.modernsupports 2026-07-28 (server/discover)
  • pass
    protocol.statelessanswers without a session
  • pass
    protocol.transportstreamable HTTP
  • pass
    protocol.list_ttltool list is cacheable (ttlMs 3600000)
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations8 of 8 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 2,738 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability25 · weight 15
  • warn
    stability.changes8 tool changes in 30 days
  • fail
    stability.rug_pull7 tools kept their name but changed most of their description in 30 days; review before trusting them
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

8 tools, about 2,738 tokens to load them all · tool set a9c273f478f7 · tools last changed 2026-10-07 · checked 2026-10-19 13:37 UTC

Tool changes

  • get_tide_windowchangedtitle, description, input schema, annotations
    before

    Per day: high and low waters together with sunrise, sunset, golden hour, twilight and moon phase in a single call. The planning tool for coastal photography, fishing and shore work. Pass elevation when you know it: it shifts the sun and moon times — roughly three minutes at clifftop height — but never the tide heights, which do not depend on where the observer stands.

    after · 69% of words in common

    Per day: high and low waters together with sunrise, sunset, golden and blue hour, twilight and moon phase in a single call. The planning tool for coastal photography, fishing and shore work; use it instead of calling get_tide_extremes and get_sun_moon_times separately. Pass elevation when you know it: it shifts the sun and moon times — roughly three minutes at clifftop height — but never the tide heights, which do not depend on where the observer stands. Defaults: from today, 2 days or the plan's limit if lower. Requires an API key on a paid Tides plan.

  • get_tide_heightschangedtitle, description, input schema, annotationsmeaning changed
    before

    Water-height time series at any coastal point, sampled at a fixed step. Metres relative to mean sea level, not chart datum.

    after · 30% of words in common

    Water height at a coastal point at a fixed step: a list of time and height_m pairs. Use it to plot a tide curve or read the height at a particular time; for just the highs and lows use get_tide_extremes. Metres relative to mean sea level, not chart datum. Defaults: from today, 2 days, and the finest step the plan allows, but no finer than 10m. Requires an API key on a paid Tides plan.

  • get_tide_extremeschangedtitle, description, input schema, annotationsmeaning changed
    before

    High and low water times and heights at any coastal point, from the FES2022 global tide atlas. Heights are metres relative to MEAN SEA LEVEL, not chart datum — never use for navigation.

    after · 43% of words in common

    High and low water times and heights at any coastal point, from the FES2022 global tide atlas: a list of events, each with type (high or low), time and height_m. Use it for when high or low tide is; for a continuous curve use get_tide_heights, and for tides together with sunrise, golden hour and moon phase use get_tide_window. Heights are metres relative to MEAN SEA LEVEL, not chart datum — never use for navigation. Defaults: from today, 2 days or the plan's limit if lower. Requires an API key on a paid Tides plan.

  • get_daily_light_integralchangedtitle, description, input schema, annotationsmeaning changed
    before

    Daily Light Integral — integrated photosynthetically active radiation per day, the horticultural measure used for growth and supplemental-lighting planning.

    after · 24% of words in common

    Clear-sky Daily Light Integral in mol/m²/day for each day in a range: photosynthetically active radiation integrated from sunrise to sunset. Use it to plan crop growth or supplemental greenhouse lighting; it assumes cloudless skies, so treat it as the ceiling for the site. Pass from and to together for a range of UTC days, or neither for today. Requires an API key on a paid Solar plan.

  • get_solar_pathchangedtitle, description, input schema, annotationsmeaning changed
    before

    The sun's track across a single day, sampled at a fixed interval. Used for shading studies, PV siting and panel-angle planning.

    after · 34% of words in common

    The sun's azimuth and altitude through one UTC day, sampled every interval: a list of timestamped positions. Use it for shading studies, PV siting and panel-angle planning; for a single instant use get_solar_position. date defaults to today and interval to 15m. Requires an API key on a paid Solar plan.

  • get_solar_positionchangedtitle, description, input schema, annotationsmeaning changed
    before

    Solar azimuth, altitude and zenith plus clear-sky irradiance (direct, diffuse and global horizontal, W/m²) at an instant. NREL SPA-equivalent on JPL DE421; irradiance from the Bird model.

    after · 31% of words in common

    The sun's position at one instant: azimuth, altitude, zenith, declination, hour angle and equation of time, plus clear-sky irradiance (GHI, DNI and DHI in W/m²) when include asks for it and the plan covers it. Use it for where the sun is at a given moment; for its track through a whole day use get_solar_path, and for rise and set times use get_sun_moon_times. timestamp defaults to now. Positions are NREL SPA-equivalent on JPL DE421; irradiance comes from the Bird clear-sky model. Requires an API key on a paid Solar plan.

  • get_prayer_timeschangedtitle, description, input schema, annotationsmeaning changed
    before

    The five daily Islamic prayer times for a location, elevation-corrected. Supports every major calculation school and both Asr shadow rules.

    after · 25% of words in common

    Fajr, sunrise, dhuhr, asr, maghrib and isha for one date at a location, elevation-corrected. Use it for Islamic prayer schedules; for general sunrise, sunset and twilight use get_sun_moon_times. school is required and sets the fajr and isha rules; asr_method picks the shadow rule and defaults to shafi. date defaults to today. Requires an API key on a paid Ephemerides plan.

  • get_sun_moon_timeschangedtitle, description, input schema, annotationsmeaning changed
    before

    Sunrise, sunset, solar noon, twilight phases, moonrise, moonset and moon phase for any point on Earth, on any date. Accepts elevation, which shifts sunrise and sunset at altitude — pass it whenever you know it.

    after · 29% of words in common

    Sunrise, sunset, solar noon, civil, nautical and astronomical twilight, golden and blue hour, moonrise, moonset and moon phase for a location, one entry per day. Use it for any question about when the sun or moon rises, sets or gets dark; for the sun's angle at a given moment use get_solar_position, and for tides alongside the sun use get_tide_window. Pass elevation whenever you know it: it shifts sunrise and sunset at altitude. Defaults: from today, 7 days or the plan's limit if lower. Requires an API key on a paid Ephemerides plan.

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 96 / 100

provenance90
liveness96
freshness100
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-91% +updated-27d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://thirdtrail.life/mcp streamable-httpapi_key ${THIRDTRAIL_TOKEN}yes91%506 ms2026-07-28, 2025-11-25, 2025-06-18, 2025-03-262026-10-19

Tools (8)

get_daily_light_integralread-onlyClear-sky Daily Light Integral in mol/m²/day for each day in a range: photosynthetically active radiation integrated from sunrise to sunset. Use it to plan crop growth or supplemental greenhouse lighting; it assumes cloudless skies, so treat it as the ceiling for the site. Pass from and to together for a range of UTC days, or neither for today. Requires an API key on a paid Solar plan.
get_prayer_timesread-onlyFajr, sunrise, dhuhr, asr, maghrib and isha for one date at a location, elevation-corrected. Use it for Islamic prayer schedules; for general sunrise, sunset and twilight use get_sun_moon_times. school is required and sets the fajr and isha rules; asr_method picks the shadow rule and defaults to shafi. date defaults to today. Requires an API key on a paid Ephemerides plan.
get_solar_pathread-onlyThe sun's azimuth and altitude through one UTC day, sampled every interval: a list of timestamped positions. Use it for shading studies, PV siting and panel-angle planning; for a single instant use get_solar_position. date defaults to today and interval to 15m. Requires an API key on a paid Solar plan.
get_solar_positionread-onlyThe sun's position at one instant: azimuth, altitude, zenith, declination, hour angle and equation of time, plus clear-sky irradiance (GHI, DNI and DHI in W/m²) when include asks for it and the plan covers it. Use it for where the sun is at a given moment; for its track through a whole day use get_solar_path, and for rise and set times use get_sun_moon_times. timestamp defaults to now. Positions are NREL SPA-equivalent on JPL DE421; irradiance comes from the Bird clear-sky model. Requires an API key on a paid Solar plan.
get_sun_moon_timesread-onlySunrise, sunset, solar noon, civil, nautical and astronomical twilight, golden and blue hour, moonrise, moonset and moon phase for a location, one entry per day. Use it for any question about when the sun or moon rises, sets or gets dark; for the sun's angle at a given moment use get_solar_position, and for tides alongside the sun use get_tide_window. Pass elevation whenever you know it: it shifts sunrise and sunset at altitude. Defaults: from today, 7 days or the plan's limit if lower. Requires an API key on a paid Ephemerides plan.
get_tide_extremesread-onlyHigh and low water times and heights at any coastal point, from the FES2022 global tide atlas: a list of events, each with type (high or low), time and height_m. Use it for when high or low tide is; for a continuous curve use get_tide_heights, and for tides together with sunrise, golden hour and moon phase use get_tide_window. Heights are metres relative to MEAN SEA LEVEL, not chart datum — never use for navigation. Defaults: from today, 2 days or the plan's limit if lower. Requires an API key on a paid Tides plan.
get_tide_heightsread-onlyWater height at a coastal point at a fixed step: a list of time and height_m pairs. Use it to plot a tide curve or read the height at a particular time; for just the highs and lows use get_tide_extremes. Metres relative to mean sea level, not chart datum. Defaults: from today, 2 days, and the finest step the plan allows, but no finer than 10m. Requires an API key on a paid Tides plan.
get_tide_windowread-onlyPer day: high and low waters together with sunrise, sunset, golden and blue hour, twilight and moon phase in a single call. The planning tool for coastal photography, fishing and shore work; use it instead of calling get_tide_extremes and get_sun_moon_times separately. Pass elevation when you know it: it shifts the sun and moon times — roughly three minutes at clifftop height — but never the tide heights, which do not depend on where the observer stands. Defaults: from today, 2 days or the plan's limit if lower. Requires an API key on a paid Tides plan.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.thirdtrail/thirdtrail",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
  "remotes": [
    {
      "url": "https://thirdtrail.life/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Your thirdtrail API key as 'Bearer tt_live_…'. Mint one at https://thirdtrail.life/apis/keys/. The MCP server requires a paid plan; the REST API has a free tier."
        }
      ]
    }
  ],
  "version": "1.0.0",
  "repository": {
    "url": "https://github.com/thirdtrail/thirdtrail-python",
    "source": "github"
  },
  "websiteUrl": "https://thirdtrail.life/docs/mcp/",
  "description": "Elevation-corrected sun, moon, twilight, solar and tide data for any point on Earth"
}