search

πŸ”±Poseidon (The Bridge)

Your guide to connecting Athena to the outside world

Ο€ΟŒΞ½Ο„ΞΏΟ… αΌ„Ξ½Ξ±ΞΎ β€” Lord of the Sea. He carries the truth of all messages that have been authorized to move, across whatever sea is required.

hashtag
What is Poseidon?

Poseidon is the bridge between Athena's thoughts and the outside world. Where Athena thinks, Poseidon carries.

When you ask your AI to check the weather, create a record in Salesforce, or manage your calendarβ€”Athena decides what to do, but Poseidon makes it happen. He is the transport layer, the sea through which all authorized actions flow.

In Olympus-Grid:

  • Athena = the mind (thinks, reasons, decides)

  • Poseidon = the bridge (carries, connects, executes)

Without Poseidon, Athena can only talk. With Poseidon, she can act.

In this guide, you'll learn how to:

  • Download Poseidon's code

  • Run him on your own computer

  • Connect him to Athena

  • Add your first cloud connection

  • Watch your AI take action in the real world

Time needed: About 30 minutes

What you'll need:

  • A computer (Mac, Windows, or Linux)

  • Athena running locally (complete the {INSERTGUIDEHERE} first)

  • Your olympus-616 folder from the Athena setup

Currently supported connections:

  • 🌀️ Weather (free, no account needed)

  • ☁️ Salesforce (OAuth)

  • πŸ“… Google Calendar (coming soon)

πŸ’‘ Don't see the connection you want? Add your own and submit a Pull Request!

hashtag
Part 1: Getting Started

hashtag
Step 1.1 β€” Make Sure Athena is Running

Before we set up Poseidon, Athena needs to be alive.

Open a terminal and check if Athena is running:

πŸ’š Expected response:

If you don't see this, go back to the Athena Guidearrow-up-right and complete the setup first.

πŸ’š Athena is running.

hashtag
Step 1.2 β€” Download Poseidon's Code

Open a new terminal window and navigate to your olympus-616 folder:

Then run this command to download Poseidon:

What is {{olympus-616}}?

This is the address of your code server. For most people, this is github.com. So the command becomes:

Advanced users can configure their own code server by updating their SSH config. See the [Eos CI/CD Guide] for details.

Now move into Poseidon's folder:

πŸ’š You now have Poseidon's code on your computer.

To confirm, run:

You should see files like README.md and folders like mcp and deploy.

πŸ’š Poseidon is downloaded and ready.

hashtag
Step 1.3 β€” Run Poseidon Locally

Now let's bring Poseidon to life.

a) Move into the MCP folder:

b) Install the required packages:

This downloads all the code libraries Poseidon needs.

c) Create your configuration file:

On Mac/Linux:

On Windows:

d) Start Poseidon:

πŸ’š Poseidon is now running.

You should see something like this:

πŸ’š Poseidon is running on port 3431.

Notice the tools that are already available:

  • 🌀️ Weather alerts and forecasts (free, no setup needed)

  • ☁️ Salesforce tools (requires OAuth setupβ€”we'll do this later)

⚠️ Don't close this terminal window! Poseidon needs it to stay alive. You should now have two terminals openβ€”one for Athena (port 3401) and one for Poseidon (port 3431).

hashtag
Step 1.4 β€” Test Poseidon's Health

Open another terminal window and run:

πŸ’š Expected response:

πŸ’š Poseidon is alive and listening.

hashtag
Step 1.5 β€” Connect Poseidon to Athena

Now we need to tell Athena where to find Poseidon.

a) Open Athena's configuration file:

Navigate to your Athena API folder and open the .env file:

Open .env in your text editor.

b) Find the MCP server line:

This should already be set correctly. If not, add or update this line.

c) Restart Athena:

Go to the terminal where Athena is running.

Press Ctrl + C to stop Athena.

Then start her again:

πŸ’š Athena is now connected to Poseidon.

hashtag
Step 1.6 β€” Your First Action: Check the Weather

Let's test the connection by asking Athena to do something that requires Poseidon.

Open Temple Turtle in your browser (http://localhost:3402) or use curl:

πŸ’š Athena will respond with real weather data.

What just happened:

  1. You asked Athena about the weather

  2. Athena decided she needed to check an external service

  3. She sent a request to Poseidon

  4. Poseidon carried the request to the weather API

  5. The response flowed back through Poseidon to Athena

  6. Athena gave you the answer

The mind thought. The bridge carried. You got the answer.

πŸ’š Poseidon is working.

hashtag
πŸŽ‰ Congratulations!

You just connected Athena to the outside world.

Your AI can now take actionβ€”not just think. Poseidon carries her intentions across the sea to any system you connect.

Let's recap what you accomplished:

  • βœ… Downloaded Poseidon's code from the grid

  • βœ… Started the bridge (MCP Server on port 3431)

  • βœ… Connected Poseidon to Athena

  • βœ… Watched your AI fetch real data from the outside world

hashtag
What's Next?

hashtag
☁️ Connect to Salesforce

Want Athena to create records, query data, and manage your Salesforce org? Learn how to set up OAuth and connect Poseidon to Salesforce.

β†’ Salesforce Connection Guidearrow-up-right

hashtag
πŸ“… Connect to Google Calendar (coming soon)

Let Athena manage your schedule, create events, and check your availability.

β†’ Google Calendar Connection Guidearrow-up-right

hashtag
πŸ› οΈ Build Your Own Connection

Want to connect Athena to a system we don't support yet? Learn how to add new MCP tools to Poseidon.

β†’ Building Custom MCP Toolsarrow-up-right

hashtag
Need Help?

Ο€ΟŒΞ½Ο„ΞΏΟ… αΌ„Ξ½Ξ±ΞΎ carries the truth of all messages that have been authorized to move, across whatever sea is required. At brain/1.3.x.x, this is the movement layer of Olympus-616 β€” the place where intent becomes motion, and motion survives the depths.

The sea is ready. 🌊

PreviousAthena (The Mind)NextApollo (The Sound)

Last updated