Outdooriq Mcp

io.github.bch1212Published by GitHub account bch1212v0.1.0Updated Nov 2, 2026

Paid MCP for fishing/lake/stocking intelligence — 72k+ US lakes, 293k+ events.

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & Analytics

Overview

AI-generated overview

Paid remote MCP server giving assistants US lake, fish-stocking and fishing-favorability data plus live weather for trip and fishing recommendations.

What you can do
  • Search and browse lakes by name, state, county or acreage, and get details such as coordinates, depth, species and facilities
  • Look up nearby lakes around a GPS point, ranked by a 0-100 fishing-favorability score, and list top-scoring lakes by state or species
  • Retrieve stocking history and recent stocking schedules filtered by lake, species, year or month, and list actively stocked species
  • Fetch current weather and a 7-day forecast for a lake, and generate a natural-language fishing report summary
When to use it
Useful when building or running a fishing, trip-planning, travel-concierge or outdoor-brand assistant that needs to recommend lakes, time visits around stocking events, or pull an on-demand fishing report instead of assembling several data sources.
Requirements
Remote streamable HTTP endpoint; no local package. Requires an API key sent in the X-API-Key header. A free dev key is offered with a 50 calls/day limit; Pro is $14/mo and pay-as-you-go is $0.01/call. Weather comes from Open-Meteo and needs no key.
Before you install
It is a paid service: beyond the free daily quota, usage costs money per month or per call. The API key is a secret sent in the X-API-Key header and should not be shared. Queries (lake IDs, coordinates, species filters) go to a third-party endpoint. The README notes a SQLite fallback with a much smaller seed dataset, so results may be limited if the full database is unavailable.

Installation

In SourceWeft

  1. Open Outdooriq Mcp in the dashboard and add it to a workspace.
  2. Connect X-API-Key credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.bch1212%2Foutdooriq-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "outdooriq": {
      "type": "http",
      "url": "https://mcp.castiq.net/mcp",
      "headers": {
        "X-API-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

OutdoorIQ MCP — Outdoor Recreation Intelligence

Powered by 72,000+ US lakes and 293,000+ stocking events across 12 states.

OutdoorIQ MCP is a paid MCP server that exposes lake conditions, fish-stocking records, fishing-favorability scoring, and live weather to AI agents. It is built on the CastIQ dataset (the same data that powers fishing-seo.pages.dev and the CastIQ catalog APIs).

If you're building a trip-planning assistant, a fishing app, a travel concierge, or an outdoor-brand agent that needs to recommend lakes, time visits to recent stocking events, or pull a fishing report on demand, this is the data layer you wire up.

For consumer-facing AI products, OutdoorIQ replaces a ten-source ETL with one authenticated MCP endpoint — and bills predictably so you don't get a surprise S3 invoice the first weekend traffic spikes.


Pricing

TierPriceLimits
Free$0outdooriq-dev-key-001, 50 calls/day
Pro$14/moUnlimited
Pay-as-you-go$0.01/callNo monthly minimum

Listing & checkout: https://mcpize.com/outdooriq-mcp


Install in Claude

Live URL: https://mcp.castiq.net/mcp (Railway fallback: https://web-production-9b8950.up.railway.app/mcp)

The fastest path uses mcp-remote as a stdio→HTTP bridge:

bash
claude mcp add outdooriq-mcp -- npx -y mcp-remote \  https://mcp.castiq.net/mcp \  --header "X-API-Key:outdooriq-dev-key-001"

Or configure manually:

json
{  "mcpServers": {    "outdooriq-mcp": {      "url": "https://mcp.castiq.net/mcp",      "headers": { "X-API-Key": "outdooriq-dev-key-001" }    }  }}

Anthropic MCP Registry entry: io.github.bch1212/outdooriq-mcp — listed at https://registry.modelcontextprotocol.io.

Example agent prompt:

"Find top 5 trout lakes near Chicago for this weekend."

The agent calls get_nearby_lakes (lat/lng of Chicago, radius 200mi), filters for species: trout via get_top_lakes, then pulls get_fishing_report_summary for the top match.


Tool Reference

ToolArgsReturns
search_lakesname?, state?, county?, min_acres?, max_acres?, limit?List of matching lakes
get_lake_detailslake_idCoords, acreage, depth, species, facilities
get_stocking_datalake_id?, species?, year?, limit?Recent stocking events
get_fishing_scorelake_id0-100 score with bucket breakdown
get_nearby_lakeslat, lng, radius_miles?, min_score?, limit?Lakes near GPS, sorted by score
get_weather_for_lakelake_idCurrent + 7-day forecast (Open-Meteo)
get_top_lakesstate?, species?, limit?Highest-scoring lakes
get_stocking_schedulestate?, species?, month?, limit?Most-recent matching events as a planning prior
search_speciesstate?, season?Actively-stocked species
get_fishing_report_summarylake_idNatural-language report

Architecture

client (Claude / agent)        │  HTTP POST /mcp  (JSON-RPC 2.0)        ▼   FastAPI app (server.py)        │  X-API-Key auth + per-day rate limiter        ▼  Tool registry (10 tools)        │        ▼  db.connection.py  ──────┐        │ Postgres mode  │  → CastIQ Postgres (72k lakes, 293k stockings)        │ SQLite fallback│  → bundled seed (100+ lakes, ~150 stockings)        ▼  tools.* (lakes, stocking, scoring, weather, reports)        │        ▼  Open-Meteo (no key)

Postgres vs SQLite mode

The server picks a backend at startup:

  1. If DATABASE_URL is set, it tries asyncpg.create_pool. On success → logs [OutdoorIQ] Running in Postgres mode.
  2. If the pool fails (timeout, bad creds, DB down) or DATABASE_URL is unset, the server seeds an in-memory SQLite DB with 100+ real lakes and logs [OutdoorIQ] Running in SQLite fallback mode.

The server always starts, regardless of Postgres availability.

CapabilityPostgres modeSQLite fallback
Lake catalog72,669 (12 states)~106 (WI, MN, IL, IA, MO)
Stocking events293,821 historical~150 templated, recency-tuned
Species coverageAll states/species in CastIQCurated subset (walleye, bass, musky, trout, crappie, perch, pike, panfish, salmon, lake_trout, sauger, white_bass, sturgeon, catfish, bluegill, smallmouth_bass)
Year-over-year analysisYes — multi-year stockingsLimited — events are anchored relative to "now"
Stocking-schedule toolReal historical patternsApproximated from seed
Weather, scoring, reportsIdenticalIdentical

Local development

bash
git clone <this repo>cd mcp-outdoorspython3 -m venv .venv && source .venv/bin/activatepip install -r requirements.txt
# Run with SQLite fallback (no DATABASE_URL needed)python -m run
# OR run against the CastIQ Postgresexport DATABASE_URL=postgresql://vikinetic:vikinetic_dev@localhost:5444/vikineticpython -m run

Then:

bash
curl -s http://localhost:8080/healthcurl -s -X POST http://localhost:8080/mcp \  -H "X-API-Key: outdooriq-dev-key-001" \  -H "Content-Type: application/json" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tests

bash
pytest -v

The test suite covers both the SQLite fallback path and the Postgres dispatch path (via a mocked asyncpg pool), plus auth, rate limits, all 10 tools, JSON-RPC initialize / list / call, and the scoring algorithm's bucket math.


Deploy to Railway

A deploy.sh script is included at the repo root. Run it on your Mac (the Cowork sandbox can't reach Railway/Stripe/Cloudflare APIs):

bash
./deploy.sh

It expects RAILWAY_API_TOKEN (or RAILWAY_TOKEN exported as RAILWAY_API_TOKEN), points the project at nixpacks.toml, and sets the DATABASE_URL env var if you've also provisioned the CastIQ Postgres on Railway.

Railway gotcha (already handled): Railway exec's startCommand without a shell, so $PORT doesn't expand. We use python -m run and read PORT from os.environ inside run.py.


MCPize listing copy

OutdoorIQ MCP — the data layer for outdoor-rec AI agents. 72,000+ US lakes, 293,000+ fish-stocking events, and live weather behind one authenticated endpoint. Search lakes by name, state, or acreage; pull stocking history filtered by species and month; compute a 0-100 fishing-favorability score that bakes in recency, species diversity, lake size, and current conditions. One JSON-RPC call replaces a multi-source ETL.

Built for fishing apps, trip-planning assistants, travel concierges, and outdoor-brand agents. $14/mo Pro for unlimited use, or pay $0.01 per call. Free dev tier (50 calls/day) lets you ship a prototype before opening your wallet. Install with claude mcp add outdooriq-mcp --url https://mcp.castiq.net/mcp.


License

MIT. See LICENSE.

Source: README.md at commit 2cc3026

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts