How to integrate Beach Day API MCP with Hermes

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows. This guide explains the easiest and most robust way to connect your Beach Day API account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Beach Day API logoBeach Day API
Api Key

Beach Day API is a beach intelligence service for search, conditions, scores, rules, amenities, tides, and country coverage. Use it to power trip planning, surf reports, safety checks, and location-aware beach discovery.

8 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Beach Day API account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Beach Day API with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,000+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Beach Day API with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Beach Day API

Ask your agent to connect to Beach Day API, or simply request any Beach Day API-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Beach Day API connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Beach Day API or request any Beach Day API-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Beach Day API MCP server, and what's possible with it?

The Beach Day API MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Beach Day API account. It provides structured and secure access to beach profiles, conditions, scores, rules, amenities, tide predictions, and country coverage, so your agent can find beaches, compare scores, check current conditions, review facilities, and plan around tides on your behalf.

  • Beach search and discovery: Have your agent find beaches by name, country, or state or province.
  • Conditions and score comparisons: Let the agent review current and recent beach conditions, including weather, water quality, ocean conditions, and available tide data, or rank beaches by their current Beach Day Score.
  • Rules and amenity checks: Direct your agent to check activity rules, facilities, and accessibility amenities before you visit a beach.
  • Tide planning: Instruct your agent to retrieve up to seven days of tide predictions for a beach and help you choose when to go.
  • Beach profiles and country coverage: Have your agent pull a full beach profile or list covered countries by their number of available beaches.

Way Forward

With Beach Day API connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Beach Day API action and event your agent gets out of the box.

Get Beach Amenities

Get facilities and accessibility amenities for a beach without paying for the full beach profile.

Get Beach Details

Get a full beach profile, including current score, water quality, weather, ocean conditions, rules, and amenities.

Get Beach Rules

Get activity rules for a beach without paying for the full beach profile.

Get Tide Predictions

Get up to seven days of stored tide-prediction groups for a beach.

List Beach Conditions

Return current and recent condition snapshots for a beach, including score, water quality, weather, ocean conditions, and available tide data.

List Beaches by Score

Return beaches ranked by current Beach Day Score from highest to lowest.

List Countries

List countries covered by Beach Day API with beach counts, ordered from highest to lowest count.

Search Beaches

Find beaches by name, country, or state/province code and return IDs for detail, conditions, rules, amenities, and tide lookups.

FAQ

Frequently asked questions

With a standalone Beach Day API MCP server, the agents and LLMs can only access a fixed set of Beach Day API tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Beach Day API and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Beach Day API tools.

Yes, absolutely. You can configure which Beach Day API scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Beach Day API data and credentials are handled as safely as possible.

Start with Beach Day API.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Beach Day API tool your agent needs.Free to start.

Start building