Poseidon

Getting started

Poseidon documentation

Poseidon publishes standardized weather, grid, and shipping data and indices for AI agents and quant dashboards — over an API-key-protected REST API and an MCP server. This quickstart gets you from zero to a first grounded answer.

Quickstart

Three steps from sign-up to a live, grounded answer.

  1. 1

    Get an API key

    Pick a plan on the pricing page, then create a key from your dashboard. Keys are prefixed psk_ and shown once at creation — copy it then.

  2. 2

    Connect the MCP server

    Point Claude Code (or any Streamable-HTTP MCP client) at Poseidon. Use the full surface, or a focused one to load fewer tools.

    bash
    # Claude Code
claude mcp add --transport http poseidon https://api.poseidonmcp.com/mcp \
  --header "X-API-Key: psk_..."

# Focused surfaces (fewer tools, fewer tokens):
#   https://api.poseidonmcp.com/mcp/commodity   (shared + commodity)
#   https://api.poseidonmcp.com/mcp/grid        (shared + grid)
  3. 3

    Make a first REST call

    Prefer raw HTTP? Hit /api/v1/summary for a cross-domain snapshot. Authenticate with the X-API-Key header.

    bash
    curl https://api.poseidonmcp.com/api/v1/summary \
  -H "X-API-Key: psk_your_key_here"

Positioning

Poseidon publishes standardized data and indices, identically to all subscribers. It is not investment advice and does not make trading recommendations.

Where to next

MCP serverThree Streamable-HTTP surfaces and the full 19-tool reference.REST APIAll 23 endpoints, grouped by domain, with params.ConceptsCoverage, scoring & severity, and the publisher-exemption positioning.