Overview
What FishPulse does
FishPulse answers "is this a good time to fish here?" with a 0-100 score an AI agent or app can reason over, built from live NOAA data and computed astronomy, with every factor shown.
- GET /v1/conditions?lat=27.7606&lon=-82.6269 returns the score now, a verdict, conditions (air temperature, wind, sky and precipitation chance from the NWS hourly forecast; barometric pressure and its 3-hour trend from the nearest NWS observation station; water temperature and tide state from NOAA CO-OPS), tide times, moon phase, solunar major and minor periods, sunrise and sunset, ratings for up to 4 species, an optimal window, score_breakdown and data_sources. Optional water_temp_f lets you pass your own reading.
- GET /v1/forecast?lat=27.7606&lon=-82.6269&days=3 returns a daily outlook for 1-7 days (days above 7 answers 400, not billed) from the NWS forecast, with tide times, moon phase and solunar periods per day, and the best day.
- GET /v1/compare?spots=27.7606,-82.6269;41.4993,-81.6944 ranks 2-5 spots, each scored from its own live NOAA data.
- GET /v1/species/{name} returns built-in reference data for 12 species (temperature range, ideal temperature, pressure preference, depth, notes). No key needed and not billed.
Where the data comes from
Weather: NOAA National Weather Service (api.weather.gov) hourly forecast for air temperature, wind, precipitation chance and sky; its 12-hour forecast (about 7 days) for /v1/forecast; and the nearest NWS observation station (within 60 km) for barometric pressure and its 3-hour trend (null when no reading in the last 3 hours). Tides: NOAA CO-OPS high/low tide predictions from the nearest prediction station within 25 km (null inland and on the Great Lakes, with the reason). Water temperature: the latest NOAA CO-OPS measurement within 30 km (null with the reason when there is none; you can pass your own water_temp_f). Moon phase, illumination, moonrise/moonset, solunar major periods (2 hours around the moon's overhead and underfoot transits) and minor periods (1 hour around moonrise and moonset), sunrise and sunset are computed with Astronomy Engine (MIT licence). Every answer has data_sources (which source fed each field, or why it is null) and score_breakdown (each factor's input and points).
Score 0-100: base 50; water temperature 65-75 F +20, 60-80 F +10, below 50 or above 85 F -15; wind 5-12 mph +10, above 20 mph -15, below 3 mph -5; pressure 3-hour trend falling +15, stable +5, rising -5; tide incoming +10, outgoing +5; inside a solunar major period +10, minor +5; moon day (within 1 day of new or full moon) +5, within 3 days +3; precipitation chance 70% or more -10, 40% or more -5. /v1/forecast scores each day on water temperature (latest reading), daytime wind, precipitation chance and the moon day (+10 / +5). A factor whose source is unavailable adds 0.
- Weather: NOAA National Weather Service (api.weather.gov). Tides and water temperature: NOAA CO-OPS Tides & Currents (tidesandcurrents.noaa.gov). US Government data, public domain; FishPulse is not endorsed by NOAA. Moon and solunar times computed with Astronomy Engine (MIT licence).
Three ways to connect
- REST with an X-API-Key header, described by an OpenAPI 3 schema (https://fishpulse.waltsoft.net/openapi.json ).
- MCP: the tool fishpulse___getFishConditions (lat, lon) on the Amazon Bedrock AgentCore Gateway, for Claude, Strands Agents and other MCP clients.
- A2A (Agent2Agent 0.3): the agent card at https://fishpulse.waltsoft.net/.well-known/agent-card.json with the skills getFishingConditions, getFishingForecast, compareFishingSpots and getSpeciesInfo.
Who it is for
Outdoor and fishing apps and AI agents that want one call for a fishing score from live NOAA weather, tides and water temperature, with moon and solunar timing, for US locations.
Billing
On AWS Marketplace, 1 unit ($0.06) per successful call on every paid route, billed on your AWS bill. With x402 (USDC, no subscription): $0.05 per call. Only successful calls are billed; errors, including NWS outages (503), are never billed. Rate limit: 50 requests per second, bursts up to 100.
Highlights
- Fishing score 0-100 in one call from live NOAA data: NWS forecast and observed pressure trend, CO-OPS tides and measured water temperature, plus computed moon phase and solunar periods
- Transparent scoring: every answer has score_breakdown (each factor's input and points) and data_sources (which source fed each field, or why it is null); 1-7 day outlook and 2-5 spot comparison
- Agent-ready: REST with an OpenAPI 3 schema, an MCP tool on Amazon Bedrock AgentCore Gateway and an A2A agent card; only successful calls are billed on your AWS bill
Details
Introducing multi-product solutions
You can now purchase comprehensive solutions tailored to use cases and industries.
Features and programs
Financing for AWS Marketplace purchases
Quick Launch
Pricing
Dimension | Description | Cost/unit |
|---|---|---|
API Call | Single API call to the service | $0.06 |
Vendor refund policy
No refunds for API calls already made. Contact support@waltsoft.net within 7 days of billing issues.
How can we make this page better?
Legal
Vendor terms and conditions
Content disclaimer
Delivery details
- Amazon Bedrock AgentCore
API-Based Agents & Tools
API-Based Agents and Tools integrate through standard web protocols. Your applications can make API calls to access agent capabilities and receive responses.
Additional details
Usage instructions
To get started using the remote MCP server, follow the instructions below:
Available Tools This MCP server (Amazon Bedrock AgentCore Gateway) supports the following tool:
- fishpulse___getFishConditions - Fishing score 0-100 now for a US location from live NOAA data, with conditions, tide, moon, solunar periods, up to 4 species ratings, optimal window, score_breakdown and data_sources (same answer as GET /v1/conditions). Arguments: lat (e.g. 27.7606), lon (e.g. -82.6269), api_key
Data: NWS forecast (air temperature, wind, precipitation chance) and observed pressure trend; NOAA CO-OPS tides (station within 25 km) and measured water temperature (within 30 km); computed moon phase and solunar periods. A field with no nearby source is null and data_sources says why (no tides inland or on the Great Lakes).
Prerequisites
- An active subscription to this product. Your API key (it starts with mp_) is stored in your AWS Secrets Manager after you choose Set up your account, and is also shown on the registration page.
- Install Node.js and npm (for mcp-remote), or Python 3.10+ (for the Strands Agents SDK).
Authentication The MCP endpoint needs no connection header. Pass your key as the api_key argument of every tool call; replace YOUR_API_KEY with your actual key below. A wrong or inactive key returns error code 401.
MCP endpoint: https://waltsoft-marketplace-gateway-xncyjgs1uh.gateway.bedrock-agentcore.us-east-1.amazonaws.com/mcp
Claude Desktop Edit the configuration file at:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the below code:
{ "mcpServers": { "waltsoft-fishpulse": { "command": "npx", "args": [ "mcp-remote", "https://waltsoft-marketplace-gateway-xncyjgs1uh.gateway.bedrock-agentcore.us-east-1.amazonaws.com/mcp" ] } } }Then ask, for example: "Use fishpulse___getFishConditions with lat 27.7606, lon -82.6269 and api_key YOUR_API_KEY".
Strands Agents (Python)
pip install strands-agents mcp from mcp.client.streamable_http import streamable_http_client from strands.tools.mcp import MCPClient URL = "https://waltsoft-marketplace-gateway-xncyjgs1uh.gateway.bedrock-agentcore.us-east-1.amazonaws.com/mcp" with MCPClient(lambda: streamable_http_client(URL)) as mcp: result = mcp.call_tool_sync("call-1", "fishpulse___getFishConditions", {"lat": 27.7606, "lon": -82.6269, "api_key": "YOUR_API_KEY"}) print(result["content"][0]["text"])Example tool result (trimmed)
{"score": 80, "verdict": "Excellent — go fishing!", "conditions": {"water_temp_f": 75.7, "air_temp_f": 79, "wind_mph": 10, "wind_dir": "N", "pressure_trend": null, "tide_state": "outgoing"}, "moon": {"phase_name": "Waxing Gibbous", "illumination_pct": 86}, "species_intel": {"largemouth_bass": {"rating": "good", "reason": "Within active range, 6°F from ideal"}}, "optimal_window": "Now: Minor solunar period 16:13-17:13 (moonrise) until 17:13", "data_sources": {"tide": {"status": "ok", "source": "NOAA CO-OPS tide predictions, station 8726520 St. Petersburg (0 km), cutoff 25 km"}, "pressure": {"status": "unavailable"}}, "attribution": "... FishPulse is not endorsed by NOAA. ..."}A location outside NWS coverage returns 400 and an NWS outage returns 503; neither is billed. Each successful call is 1 unit ($0.06). The 1-7 day forecast and spot comparison are on REST and A2A.
Rate Limits
- 50 requests per second (bursts up to 100).
- Exceeding returns HTTP 429 Too Many Requests.
- Retry with exponential backoff.
Data sources NOAA National Weather Service and NOAA CO-OPS Tides & Currents (public domain); FishPulse is not endorsed by NOAA. Moon and solunar times: Astronomy Engine (MIT licence).
Learn More API Docs: https://fishpulse.waltsoft.net Support: support@waltsoft.net
Support
Vendor support
Contact support@waltsoft.net . Documentation:
AWS infrastructure support
AWS Support is a one-on-one, fast-response support channel that is staffed 24x7x365 with experienced and technical support engineers. The service helps customers of all sizes and technical abilities to successfully utilize the products and features provided by Amazon Web Services.