Skip to main content
Glama

KaiCast Ocean Conditions

by com.kaicast
OverviewDiscussionsAdmin

Find the best day

best_day
Read-onlyIdempotent

Which day in a window (max 7 days) is best for an activity at a destination — a spot, a region, or lat+lon with a radius — and why, versus the runner-up. Returns every day's best score, confidence, caveats and a KaiCast spot card for the winner. Free during early access.

Input Schema

NameRequiredDescriptionDefault
toNoWindow end, inclusive, at most 7 days. Default: from + 6.
latNoLatitude, decimal degrees. Use with lon.
lonNoLongitude, decimal degrees. Use with lat.
fromNoWindow start, spot-local. Default: today.
spotNoSpot id, e.g. "hanauma-bay".
regionNoRegion id, e.g. "us-hi-oahu".
activityYesWhat the user wants to do.
radius_kmNoSearch radius around lat/lon in km (default 40, max 100).

Output Schema

NameRequiredDescriptionDefault
bestNo
daysNo
schemaYes
sourceYes
statusYes
messageNo
coverageYes
disclaimerYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / best / anyOf
      Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "card": {
-        "additionalProperties": {},
-        "properties": {
-          "cta": {
-            "additionalProperties": {},
-            "properties": {
-              "label": {
-                "type": "string"
-              },
-              "url": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "label",
-              "url"
-            ],
-            "type": "object"
-          },
-          "date": {
-            "type": "string"
-          },
-          "links": {
-            "additionalProperties": {},
-            "properties": {
-              "app": {
-                "type": "string"
-              },
-              "forecast": {
-                "type": "string"
-              },
-              "share": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "share",
-              "app",
-              "forecast"
-            ],
-            "type": "object"
-          },
-          "score": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "spot_id": {
-            "type": "string"
-          },
-          "spot_name": {
-            "type": "string"
-          },
-          "tier": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "tier_label": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "spot_id",
-          "spot_name",
-          "tier",
-          "tier_label",
-          "score",
-          "date",
-          "links",
-          "cta"
-        ],
-        "type": "object"
-      },
-      "caveats": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "code",
-            "message"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "confidence": {
-        "additionalProperties": {},
-        "properties": {
-          "label": {
-            "type": "string"
-          },
-          "value": {
-            "type": "number"
-          }
-        },
-        "required": [
-          "value",
-          "label"
-        ],
-        "type": "object"
-      },
-      "date": {
-        "type": "string"
-      },
-      "date_label": {
-        "type": "string"
-      },
-      "rank": {
-        "type": "number"
-      },
-      "rating": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "score": {
-        "type": "number"
-      },
-      "spot": {
-        "additionalProperties": {},
-        "properties": {
-          "id": {
-            "type": "string"
-          },
-          "name": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "id",
-          "name"
-        ],
-        "type": "object"
-      },
-      "why": {
-        "additionalProperties": {},
-        "properties": {
-          "summary": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "summary"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "rank",
-      "spot",
-      "date",
-      "score",
-      "rating",
-      "why",
-      "confidence",
-      "caveats",
-      "card",
-      "date_label"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "card": {
+        "additionalProperties": {},
+        "properties": {
+          "cta": {
+            "additionalProperties": {},
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "url": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "label",
+              "url"
+            ],
+            "type": "object"
+          },
+          "date": {
+            "type": "string"
+          },
+          "links": {
+            "additionalProperties": {},
+            "properties": {
+              "app": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "forecast": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "share": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "share",
+              "app",
+              "forecast"
+            ],
+            "type": "object"
+          },
+          "score": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "spot_id": {
+            "type": "string"
+          },
+          "spot_name": {
+            "type": "string"
+          },
+          "tier": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "tier_label": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "spot_id",
+          "spot_name",
+          "tier",
+          "tier_label",
+          "score",
+          "date",
+          "links",
+          "cta"
+        ],
+        "type": "object"
+      },
+      "caveats": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "confidence": {
+        "additionalProperties": {},
+        "properties": {
+          "label": {
+            "type": "string"
+          },
+          "value": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "value",
+          "label"
+        ],
+        "type": "object"
+      },
+      "date": {
+        "type": "string"
+      },
+      "date_label": {
+        "type": "string"
+      },
+      "rank": {
+        "type": "number"
+      },
+      "rating": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "score": {
+        "type": "number"
+      },
+      "spot": {
+        "additionalProperties": {},
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "name"
+        ],
+        "type": "object"
+      },
+      "why": {
+        "additionalProperties": {},
+        "properties": {
+          "summary": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "summary"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "rank",
+      "spot",
+      "date",
+      "score",
+      "rating",
+      "why",
+      "confidence",
+      "caveats",
+      "card",
+      "date_label"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
  2. Changed2 schema fields changed
    • removedOutput schema / properties / cards
      Removed value: -{
-  "items": {
-    "additionalProperties": {},
-    "properties": {
-      "cta": {
-        "additionalProperties": {},
-        "properties": {
-          "label": {
-            "type": "string"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "label",
-          "url"
-        ],
-        "type": "object"
-      },
-      "date": {
-        "type": "string"
-      },
-      "links": {
-        "additionalProperties": {},
-        "properties": {
-          "app": {
-            "type": "string"
-          },
-          "forecast": {
-            "type": "string"
-          },
-          "share": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "share",
-          "app",
-          "forecast"
-        ],
-        "type": "object"
-      },
-      "score": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "spot_id": {
-        "type": "string"
-      },
-      "spot_name": {
-        "type": "string"
-      },
-      "tier": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "tier_label": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "spot_id",
-      "spot_name",
-      "tier",
-      "tier_label",
-      "score",
-      "date",
-      "links",
-      "cta"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}
    • changedOutput schema / required
      Previous value: -[
-  "schema",
-  "status",
-  "coverage",
-  "cards",
-  "disclaimer",
-  "source"
-]New value: +[
+  "schema",
+  "status",
+  "coverage",
+  "disclaimer",
+  "source"
+]
  3. Changed2 schema fields changed
    • changedInput schema / properties / region / description
      Previous value: -"Region id from list_coverage, e.g. \"us-hi-oahu\"."New value: +"Region id, e.g. \"us-hi-oahu\"."
    • changedInput schema / properties / spot / description
      Previous value: -"Spot id from list_coverage or get_conditions, e.g. \"hanauma-bay\"."New value: +"Spot id, e.g. \"hanauma-bay\"."
  4. Changed2 schema fields changed
    • changedInput schema / properties / region / description
      Previous value: -"Region id, e.g. \"us-hi-oahu\"."New value: +"Region id from list_coverage, e.g. \"us-hi-oahu\"."
    • changedInput schema / properties / spot / description
      Previous value: -"Spot id, e.g. \"hanauma-bay\"."New value: +"Spot id from list_coverage or get_conditions, e.g. \"hanauma-bay\"."
  5. Changed2 schema fields changed
    • changedInput schema / properties / region / description
      Previous value: -"Region id from list_coverage, e.g. \"us-hi-oahu\"."New value: +"Region id, e.g. \"us-hi-oahu\"."
    • changedInput schema / properties / spot / description
      Previous value: -"Spot id from list_coverage or get_conditions, e.g. \"hanauma-bay\"."New value: +"Spot id, e.g. \"hanauma-bay\"."
  6. First observed

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), so the description's job is to add context — which it does by disclosing the return payload (every day's score, confidence, caveats, plus a KaiCast spot card for the winner) and the commercial status ('Free during early access'). It does not mention rate limits, latency, or behavior when a destination has no coverage, which is where a sibling like list_coverage would matter.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences and a short pricing note, with the core capability front-loaded and the return contents immediately after. No filler, and the em-dash parenthetical efficiently enumerates the three location modes without a bulleted restatement of the schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With a full output schema and rich annotations, the description only needs to add the comparative framing and return shape, which it does. The remaining gap is that it never says how the three location modes interact (mutually exclusive? precedence?) or what happens on zero-coverage destinations, which matters for an eight-parameter tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description earns above that by clarifying that the location can be supplied as a spot, a region, or lat+lon with a radius, which is the one thing the schema leaves ambiguous (it never states these are alternative modes). The max-7-day window and default are reinforced, though the activity enum values are left entirely to the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource: it identifies the best day within a bounded window for a named activity at a destination, and explicitly frames the result as a comparison against the runner-up. The day-level, max-7-day window implicitly separates it from best_months and get_conditions, but no sibling is named outright, so the differentiation is inferential rather than stated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied by the scope ('which day in a window is best for an activity') and by the location modes listed, but there is no explicit when-to-use/when-not guidance and no routing to best_months for longer horizons or to get_conditions for raw forecasts. The agent must infer the selection rule from the window bound alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All KaiCast Ocean Conditions toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources