@ryancardin/noaa-tides-currents-mcp-server 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,337 @@
+import { z } from 'zod';
+export declare const GetWaterLevelsSchema: z.ZodEffects<z.ZodObject<{
+    station: z.ZodString;
+    date: z.ZodOptional<z.ZodString>;
+    begin_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodNumber>;
+    datum: z.ZodOptional<z.ZodString>;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    time_zone: z.ZodOptional<z.ZodEnum<["gmt", "lst", "lst_ldt"]>>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
+}, "strip", z.ZodTypeAny, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    datum?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    datum?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}>, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    datum?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    datum?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}>;
+export declare const GetTidePredictionsSchema: z.ZodEffects<z.ZodObject<{
+    station: z.ZodString;
+    begin_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    date: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodNumber>;
+    datum: z.ZodOptional<z.ZodString>;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    time_zone: z.ZodOptional<z.ZodEnum<["gmt", "lst", "lst_ldt"]>>;
+    interval: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
+}, "strip", z.ZodTypeAny, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    datum?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    datum?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}>, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    datum?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    datum?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}>;
+export declare const GetCurrentsSchema: z.ZodEffects<z.ZodObject<{
+    station: z.ZodString;
+    date: z.ZodOptional<z.ZodString>;
+    begin_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodNumber>;
+    bin: z.ZodOptional<z.ZodNumber>;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    time_zone: z.ZodOptional<z.ZodEnum<["gmt", "lst", "lst_ldt"]>>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
+}, "strip", z.ZodTypeAny, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+}, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+}>, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+}, {
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+}>;
+export declare const GetCurrentPredictionsSchema: z.ZodEffects<z.ZodObject<{
+    station: z.ZodString;
+    date: z.ZodOptional<z.ZodString>;
+    begin_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodNumber>;
+    bin: z.ZodOptional<z.ZodNumber>;
+    interval: z.ZodOptional<z.ZodString>;
+    vel_type: z.ZodOptional<z.ZodEnum<["speed_dir", "default"]>>;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    time_zone: z.ZodOptional<z.ZodEnum<["gmt", "lst", "lst_ldt"]>>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
+}, "strip", z.ZodTypeAny, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+    vel_type?: "default" | "speed_dir" | undefined;
+}, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+    vel_type?: "default" | "speed_dir" | undefined;
+}>, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+    vel_type?: "default" | "speed_dir" | undefined;
+}, {
+    station: string;
+    interval?: string | undefined;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+    bin?: number | undefined;
+    vel_type?: "default" | "speed_dir" | undefined;
+}>;
+export declare const GetMeteorologicalDataSchema: z.ZodEffects<z.ZodObject<{
+    station: z.ZodString;
+    product: z.ZodString;
+    date: z.ZodOptional<z.ZodString>;
+    begin_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodNumber>;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    time_zone: z.ZodOptional<z.ZodEnum<["gmt", "lst", "lst_ldt"]>>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
+}, "strip", z.ZodTypeAny, {
+    product: string;
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}, {
+    product: string;
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}>, {
+    product: string;
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}, {
+    product: string;
+    station: string;
+    date?: string | undefined;
+    format?: "json" | "xml" | "csv" | undefined;
+    range?: number | undefined;
+    end_date?: string | undefined;
+    begin_date?: string | undefined;
+    units?: "english" | "metric" | undefined;
+    time_zone?: "gmt" | "lst" | "lst_ldt" | undefined;
+}>;
+export declare const GetStationsSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodString>;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml"]>>;
+    name: z.ZodOptional<z.ZodString>;
+    lat_min: z.ZodOptional<z.ZodNumber>;
+    lat_max: z.ZodOptional<z.ZodNumber>;
+    lon_min: z.ZodOptional<z.ZodNumber>;
+    lon_max: z.ZodOptional<z.ZodNumber>;
+    state: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    sort_by: z.ZodOptional<z.ZodEnum<["name", "id", "state"]>>;
+    sort_order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+}, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
+    type?: string | undefined;
+    offset?: number | undefined;
+    state?: string | undefined;
+    format?: "json" | "xml" | undefined;
+    lat_min?: number | undefined;
+    lat_max?: number | undefined;
+    lon_min?: number | undefined;
+    lon_max?: number | undefined;
+    limit?: number | undefined;
+    sort_by?: "name" | "id" | "state" | undefined;
+    sort_order?: "desc" | "asc" | undefined;
+    units?: "english" | "metric" | undefined;
+}, {
+    name?: string | undefined;
+    type?: string | undefined;
+    offset?: number | undefined;
+    state?: string | undefined;
+    format?: "json" | "xml" | undefined;
+    lat_min?: number | undefined;
+    lat_max?: number | undefined;
+    lon_min?: number | undefined;
+    lon_max?: number | undefined;
+    limit?: number | undefined;
+    sort_by?: "name" | "id" | "state" | undefined;
+    sort_order?: "desc" | "asc" | undefined;
+    units?: "english" | "metric" | undefined;
+}>;
+export declare const GetStationDetailsSchema: z.ZodObject<{
+    station: z.ZodString;
+    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
+    format: z.ZodOptional<z.ZodEnum<["json", "xml"]>>;
+}, "strip", z.ZodTypeAny, {
+    station: string;
+    format?: "json" | "xml" | undefined;
+    units?: "english" | "metric" | undefined;
+}, {
+    station: string;
+    format?: "json" | "xml" | undefined;
+    units?: "english" | "metric" | undefined;
+}>;
+export type GetWaterLevelsParams = z.infer<typeof GetWaterLevelsSchema>;
+export type GetTidePredictionsParams = z.infer<typeof GetTidePredictionsSchema>;
+export type GetCurrentsParams = z.infer<typeof GetCurrentsSchema>;
+export type GetCurrentPredictionsParams = z.infer<typeof GetCurrentPredictionsSchema>;
+export type GetMeteorologicalDataParams = z.infer<typeof GetMeteorologicalDataSchema>;
+export type GetStationsParams = z.infer<typeof GetStationsSchema>;
+export type GetStationDetailsParams = z.infer<typeof GetStationDetailsSchema>;
+export interface NoaaConfig {
+    applicationName?: string;
+}

package/dist/types.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+// Common parameter schemas
+const StationSchema = z.string().min(1).describe('Station ID');
+const DateSchema = z.string().optional().describe('Date to retrieve data for ("today", "latest", "recent", or specific date)');
+const BeginDateSchema = z.string().optional().describe('Start date (YYYYMMDD or MM/DD/YYYY)');
+const EndDateSchema = z.string().optional().describe('End date (YYYYMMDD or MM/DD/YYYY)');
+const RangeSchema = z.number().optional().describe('Number of hours to retrieve data for');
+const DatumSchema = z.string().optional().describe('Datum to use (MLLW, MSL, etc.)');
+const UnitsSchema = z.enum(['english', 'metric']).optional().describe('Units to use ("english" or "metric")');
+const TimeZoneSchema = z.enum(['gmt', 'lst', 'lst_ldt']).optional().describe('Time zone (gmt, lst, lst_ldt)');
+const FormatSchema = z.enum(['json', 'xml', 'csv']).optional().describe('Output format (json, xml, csv)');
+const BinSchema = z.number().optional().describe('Bin number');
+const IntervalSchema = z.string().optional().describe('Interval (hilo, hl, h, or a number for minutes)');
+// Water Level Schema
+export const GetWaterLevelsSchema = z.object({
+    station: StationSchema,
+    date: DateSchema,
+    begin_date: BeginDateSchema,
+    end_date: EndDateSchema,
+    range: RangeSchema,
+    datum: DatumSchema,
+    units: UnitsSchema,
+    time_zone: TimeZoneSchema,
+    format: FormatSchema,
+}).refine(data => (data.date || (data.begin_date && data.end_date) || (data.begin_date && data.range) || (data.end_date && data.range) || data.range), { message: "You must provide either 'date', 'begin_date' and 'end_date', 'begin_date' and 'range', 'end_date' and 'range', or just 'range'" });
+// Tide Predictions Schema
+export const GetTidePredictionsSchema = z.object({
+    station: StationSchema,
+    begin_date: BeginDateSchema,
+    end_date: EndDateSchema,
+    date: DateSchema,
+    range: RangeSchema,
+    datum: DatumSchema,
+    units: UnitsSchema,
+    time_zone: TimeZoneSchema,
+    interval: IntervalSchema,
+    format: FormatSchema,
+}).refine(data => (data.date || (data.begin_date && data.end_date) || (data.begin_date && data.range) || (data.end_date && data.range) || data.range), { message: "You must provide either 'date', 'begin_date' and 'end_date', 'begin_date' and 'range', 'end_date' and 'range', or just 'range'" });
+// Currents Schema
+export const GetCurrentsSchema = z.object({
+    station: StationSchema,
+    date: DateSchema,
+    begin_date: BeginDateSchema,
+    end_date: EndDateSchema,
+    range: RangeSchema,
+    bin: BinSchema,
+    units: UnitsSchema,
+    time_zone: TimeZoneSchema,
+    format: FormatSchema,
+}).refine(data => (data.date || (data.begin_date && data.end_date) || (data.begin_date && data.range) || (data.end_date && data.range) || data.range), { message: "You must provide either 'date', 'begin_date' and 'end_date', 'begin_date' and 'range', 'end_date' and 'range', or just 'range'" });
+// Current Predictions Schema
+export const GetCurrentPredictionsSchema = z.object({
+    station: StationSchema,
+    date: DateSchema,
+    begin_date: BeginDateSchema,
+    end_date: EndDateSchema,
+    range: RangeSchema,
+    bin: BinSchema,
+    interval: z.string().optional().describe('Interval (MAX_SLACK or a number for minutes)'),
+    vel_type: z.enum(['speed_dir', 'default']).optional().describe('Velocity type (speed_dir or default)'),
+    units: UnitsSchema,
+    time_zone: TimeZoneSchema,
+    format: FormatSchema,
+}).refine(data => (data.date || (data.begin_date && data.end_date) || (data.begin_date && data.range) || (data.end_date && data.range) || data.range), { message: "You must provide either 'date', 'begin_date' and 'end_date', 'begin_date' and 'range', 'end_date' and 'range', or just 'range'" });
+// Meteorological Data Schema
+export const GetMeteorologicalDataSchema = z.object({
+    station: StationSchema,
+    product: z.string().min(1).describe('Product (air_temperature, wind, etc.)'),
+    date: DateSchema,
+    begin_date: BeginDateSchema,
+    end_date: EndDateSchema,
+    range: RangeSchema,
+    units: UnitsSchema,
+    time_zone: TimeZoneSchema,
+    format: FormatSchema,
+}).refine(data => (data.date || (data.begin_date && data.end_date) || (data.begin_date && data.range) || (data.end_date && data.range) || data.range), { message: "You must provide either 'date', 'begin_date' and 'end_date', 'begin_date' and 'range', 'end_date' and 'range', or just 'range'" });
+// Station List Schema
+export const GetStationsSchema = z.object({
+    type: z.string().optional().describe('Station type (waterlevels, currents, etc.)'),
+    units: UnitsSchema,
+    format: z.enum(['json', 'xml']).optional().describe('Output format (json, xml)'),
+    name: z.string().optional().describe('Filter stations by name (partial match)'),
+    lat_min: z.number().optional().describe('Minimum latitude boundary'),
+    lat_max: z.number().optional().describe('Maximum latitude boundary'),
+    lon_min: z.number().optional().describe('Minimum longitude boundary'),
+    lon_max: z.number().optional().describe('Maximum longitude boundary'),
+    state: z.string().optional().describe('Filter stations by state code (e.g., CA, NY)'),
+    limit: z.number().optional().describe('Maximum number of stations to return'),
+    offset: z.number().optional().describe('Number of stations to skip for pagination'),
+    sort_by: z.enum(['name', 'id', 'state']).optional().describe('Field to sort results by'),
+    sort_order: z.enum(['asc', 'desc']).optional().describe('Sort order (ascending or descending)'),
+});
+// Station Details Schema
+export const GetStationDetailsSchema = z.object({
+    station: StationSchema,
+    units: UnitsSchema,
+    format: z.enum(['json', 'xml']).optional().describe('Output format (json, xml)'),
+});

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ryancardin/noaa-tides-currents-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP Server that interfaces with NOAA Tides and Currents API using FastMCP",
+  "main": "dist/index.js",
+  "bin": {
+    "noaa-mcp": "dist/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "start:http": "node dist/index.js --http --port 3000",
+    "start:http:3001": "node dist/index.js --http --port 3001",
+    "start:http:8080": "node dist/index.js --http --port 8080",
+    "dev": "ts-node-esm src/index.ts",
+    "dev:http": "ts-node-esm src/index.ts --http --port 3000",
+    "test": "vitest run",
+    "format": "prettier --write .",
+    "inspector": "npx @modelcontextprotocol/inspector ./dist/index.js"
+  },
+  "keywords": [
+    "noaa",
+    "tides",
+    "currents",
+    "mcp",
+    "fastmcp",
+    "api"
+  ],
+  "author": "Ryan Cardin",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RyanCardin15/NOAA-Tides-And-Currents-MCP.git"
+  },
+  "bugs": {
+    "url": "https://github.com/RyanCardin15/NOAA-Tides-And-Currents-MCP/issues"
+  },
+  "homepage": "https://github.com/RyanCardin15/NOAA-Tides-And-Currents-MCP#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.2",
+    "fastmcp": "^1.16.3",
+    "suncalc": "^1.9.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "prettier": "^3.0.3",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.3.2",
+    "vitest": "^0.34.6"
+  }
+}

package/smithery.yaml

@@ -0,0 +1,16 @@
+# Smithery configuration file: https://smithery.ai/docs/config#smitheryyaml
+
+startCommand:
+  type: stdio
+  configSchema:
+    # Minimal JSON Schema for configuration
+    type: object
+    properties: {}
+  exampleConfig: {}
+  commandFunction:
+    # Simple command to start the MCP server on stdio without additional configuration
+    |-
+    () => ({
+      command: 'node',
+      args: ['dist/index.js']
+    })

package/src/index.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { FastMCP } from 'fastmcp';
+import { createServer, startServer } from './server/config.js';
+import { registerAllTools } from './tools/index.js';
+
+// Create and configure the MCP server
+const server = createServer();
+
+// Register all tools
+const services = registerAllTools(server);
+
+// Start the server
+startServer(server); 

package/src/interfaces/moon.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { MoonPhaseName } from '../types/moon.js';
+
+/**
+ * Parameters for getting moon phase
+ */
+export const MoonPhaseParamsSchema = z.object({
+  date: z.string().optional().describe('Date to get moon phase for (YYYY-MM-DD format). Defaults to current date.'),
+  latitude: z.number().min(-90).max(90).optional().describe('Latitude for location-specific calculations'),
+  longitude: z.number().min(-180).max(180).optional().describe('Longitude for location-specific calculations'),
+  format: z.enum(['json', 'text']).optional().describe('Output format (json or text)')
+});
+
+export type MoonPhaseParams = z.infer<typeof MoonPhaseParamsSchema>;
+
+/**
+ * Parameters for getting moon phases for a date range
+ */
+export const MoonPhasesRangeParamsSchema = z.object({
+  start_date: z.string().describe('Start date (YYYY-MM-DD format)'),
+  end_date: z.string().describe('End date (YYYY-MM-DD format)'),
+  latitude: z.number().min(-90).max(90).optional().describe('Latitude for location-specific calculations'),
+  longitude: z.number().min(-180).max(180).optional().describe('Longitude for location-specific calculations'),
+  format: z.enum(['json', 'text']).optional().describe('Output format (json or text)')
+});
+
+export type MoonPhasesRangeParams = z.infer<typeof MoonPhasesRangeParamsSchema>;
+
+/**
+ * Parameters for getting next moon phase
+ */
+export const NextMoonPhaseParamsSchema = z.object({
+  phase: z.enum([
+    MoonPhaseName.NEW_MOON,
+    MoonPhaseName.FIRST_QUARTER,
+    MoonPhaseName.FULL_MOON,
+    MoonPhaseName.LAST_QUARTER
+  ]).describe('Moon phase to find'),
+  date: z.string().optional().describe('Starting date (YYYY-MM-DD format). Defaults to current date.'),
+  count: z.number().positive().optional().describe('Number of occurrences to return. Defaults to 1.'),
+  format: z.enum(['json', 'text']).optional().describe('Output format (json or text)')
+});
+
+export type NextMoonPhaseParams = z.infer<typeof NextMoonPhaseParamsSchema>;