Beach Day API
Beach Day API provides beach search, conditions, scores, rules, amenities, tide predictions, and country coverage data.
Verdict
Common use cases
- Scout beach locations for a destination guide
- Check tide windows before a surf trip
- Verify water quality for event permits
- Rank beaches by current conditions score
- Pull amenity lists for accessibility planning
Integration
- Vendor
- Beach Day API
- Category
- other
- Auth
- API_KEY
- Tools
- 8
- Composio slug
beach_day_api
Tools
- Get Beach Amenities
Get facilities and accessibility amenities for a beach without paying for the full beach profile. Costs 2 API credits.
- Get Beach Details
Get a full beach profile, including current score, water quality, weather, ocean conditions, rules, and amenities. Costs 5 API credits.
- Get Beach Rules
Get activity rules for a beach without paying for the full beach profile. Costs 2 API credits.
- Get Tide Predictions
Get up to seven days of stored tide-prediction groups for a beach. The provider does not publish this endpoint's credit cost.
- List Beach Conditions
Return current and recent condition snapshots for a beach, including score, water quality, weather, ocean conditions, and available tide data. Costs 3 API credits per page.
- List Beaches by Score
Return beaches ranked by current Beach Day Score from highest to lowest. Costs 10 API credits per page; use only when ranking is needed.
- List Countries
List countries covered by Beach Day API with beach counts, ordered from highest to lowest count. Costs 1 API credit.
- Search Beaches
Find beaches by name, country, or state/province code and return IDs for detail, conditions, rules, amenities, and tide lookups. Costs 1 API credit per page.
Setup
Setup guide
- 11. In Switchy, open Settings → Integrations → Add MCP and select Beach Day API. 2. You'll be prompted for an API key; generate one at beachday.io/account/api-keys after signing up for a paid plan (free tier exists but has tight limits). 3. Paste the key into Switchy and click Connect. 4. Open any Project, type '@Beach Day API list countries' and send; if you see a ranked list of countries with beach counts, the connection works. 5. To invoke a tool, @mention Beach Day API in a message and describe what you need — the AI will map your request to the appropriate endpoint (search, conditions, amenities, tides, or rules) and return structured data. 6. Monitor credit usage in your Beach Day dashboard; Switchy does not track consumption for you.
What teammates see: by default, memories from Beach Day API are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Find Top Beaches
@Beach Day API list the top five beaches in Portugal right now by Beach Day Score, then summarize why each one ranks high.
Check Surf Conditions
@Beach Day API get current conditions and seven-day tide predictions for Rincon Beach in California, then tell me if tomorrow morning looks good for surfing.
Verify Water Quality
@Beach Day API show me the latest water quality and weather conditions for Bondi Beach, then flag any issues that would stop swimming today.
Audit Beach Amenities
@Beach Day API get amenities and accessibility details for Waikiki Beach, then summarize parking, restrooms, and wheelchair access.
Check Activity Rules
@Beach Day API pull the activity rules for Cannon Beach in Oregon and tell me if dogs are allowed and whether I can have a bonfire.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Beach Day API search for beaches near Santa Monica and show me the current conditions for the top result
Found 3 beaches matching 'Santa Monica'. The top result is Santa Monica State Beach (ID: sm-ca-001). Current conditions as of 2:15 PM PST: Beach Day Score 87/100 (Excellent). Water quality: Good, last tested 24 hours ago. Air temp 72°F, water temp 64°F, wind SW 8 mph. Surf height 2-3 feet, moderate shore break. UV index 7 (high). Next high tide at 4:42 PM. This snapshot consumed 4 API credits total (1 for search, 3 for conditions).
This example chains a search with a conditions lookup, showing how the MCP handles multi-step workflows. Note the credit cost transparency—search is cheap (1 credit/page) but conditions add 3 credits per page. Users should be aware that frequent condition polling can deplete API quotas quickly if monitoring multiple beaches.
@Beach Day API what are the rules and amenities at Bondi Beach in Australia?
Bondi Beach (Sydney, NSW) rules: No alcohol permitted. Dogs prohibited year-round. Surfing allowed in designated zones only; swimming flags mark safe areas. Lifeguards on duty 7 AM–7 PM daily. Amenities: Accessible parking (12 spaces), wheelchair beach access via matting, accessible restrooms, outdoor showers (6), changing rooms, first aid station, nearby cafes and restaurants. This lookup used 4 API credits (2 for rules, 2 for amenities).
Demonstrates the MCP's ability to fetch specific beach metadata without paying for the full 5-credit profile. Useful when you only need rules or accessibility info. The separate tool calls let you control costs, but if you need both rules AND amenities AND conditions, the full beach profile (5 credits) becomes more economical than three separate calls (7 credits combined).
@Beach Day API find the top 5 beaches in California right now and draft a weekend trip recommendation based on their scores and conditions
Top 5 CA beaches by current score: 1) Coronado Beach (94, San Diego)—calm surf, 70°F water. 2) Carmel Beach (91, Monterey)—scenic, cooler 59°F. 3) Huntington Beach (89, Orange County)—good surf, warmer 66°F. 4) Pfeiffer Beach (87, Big Sur)—dramatic views, limited access. 5) Santa Monica (87, LA)—family-friendly, full amenities. Recommendation: For a relaxed family weekend, Santa Monica offers the best amenities and accessibility. Surfers should head to Huntington. Coronado wins for overall conditions but requires a longer drive from most CA metros. This query used 10 credits for the ranked list plus 15 for five condition lookups (25 total).
Showcases the MCP's ranking tool combined with AI synthesis for decision-making. The 'List Beaches by Score' tool is expensive (10 credits/page) and should only be used when ranking matters—if you already know beach names, direct search is far cheaper. This example illustrates how credit costs scale with ambition; users need API budget awareness for exploratory queries.
Use-case deep-dives
When this MCP wins for property-management guest services
A 6-person vacation-rental team in coastal markets uses Switchy to answer guest questions about nearby beaches before check-in. The Beach Day API MCP pulls current scores, water quality, and amenities in real time, so the concierge agent can recommend the safest swim spot or the beach with wheelchair access without opening a browser. The API-key auth is simple enough for the ops lead to provision once. The credit cost matters: full beach profiles run 5 credits each, so the team trains the agent to use the cheaper amenities or rules endpoints when guests ask narrow questions. If your team fields fewer than 50 beach queries a month, the credit burn stays under $20. Beyond that threshold, you're paying for convenience that a static Google Sheet might deliver for free.
When this MCP is overkill for editorial workflows
A 2-person travel blog writing about California beaches considers the Beach Day API MCP to auto-generate tide tables and condition summaries in draft posts. The search and tide-prediction tools would let the agent pull seven-day forecasts without manual lookup. But the editorial calendar moves slowly—one post every two weeks—and the writers already bookmark NOAA and local surf-report sites. The MCP's value collapses when the research cadence is this low and the writers want narrative color, not structured data. The 10-credit cost to rank beaches by score is a non-starter when the writers curate by vibe, not algorithm. Skip this MCP unless you're publishing beach content daily or need programmatic access to feed a recommendation engine.
When this MCP closes the gap for outdoor-event logistics
A 4-person event agency books beach weddings and corporate retreats along the Gulf Coast. The team uses Switchy to build day-of contingency plans: the agent queries current conditions and tide predictions for the venue beach, then drafts backup timelines if water quality drops or weather turns. The List Beach Conditions tool costs 3 credits per page but delivers the snapshot the planner needs in Slack without switching to a forecast site. The MCP shines when the team runs 10-15 events a month and needs fast, reliable condition checks across multiple beaches. If your events are inland or you only plan two beach days a year, the API-key setup and credit spend aren't worth it—just check the weather app.
Frequently asked
What does the Beach Day API MCP do in Switchy?
It lets your AI agents query real-time beach conditions—water quality, weather, tide predictions, amenities, and activity rules—across thousands of beaches worldwide. Agents can search by location, rank beaches by score, or pull detailed profiles. Useful for travel planning, event logistics, or building location-aware recommendations without leaving the Switchy workspace.
Do I need a Beach Day API key to connect this MCP?
Yes. The MCP uses API_KEY authentication, so you'll need an active Beach Day API account and key. Each tool call consumes credits from your Beach Day plan—ranging from 1 credit for country lists to 10 per page for ranked searches. Switchy doesn't provide the key; you bring your own and paste it into the connection settings.
Can the MCP book beach permits or reserve parking spots?
No. It's read-only—agents can query conditions, amenities, and rules, but they can't make reservations, submit reports, or update beach data. If you need to act on the information (book a spot, file a water-quality complaint), you'll handle that outside Switchy or via a separate integration with your booking system.
Why use this MCP instead of calling the Beach Day API directly?
The MCP wraps the API so your agents can ask natural-language questions like "Find dog-friendly beaches near San Diego with showers" without you writing code. It handles pagination, credit-cost awareness, and error parsing. If you're already building a custom app that calls the API, you don't need this—but for ad-hoc agent queries, it's faster.
Who on the team should connect the Beach Day API MCP?
Whoever owns your Beach Day API account and understands your credit budget. Each query burns credits, so the connector should know which tools are expensive (ranked searches cost 10 per page) and set usage guidelines. Once connected, any team member with workspace access can invoke the tools through their agents.