MCP

freesea speaks MCP at https://freesea.dev/mcp over streamable HTTP. It is stateless and authenticates with the same key as the REST API.

Claude Code

claude mcp add --transport http freesea https://freesea.dev/mcp \
  --header "Authorization: Bearer freesea_sk_…"

{
  "mcpServers": {
    "freesea": {
      "url": "https://freesea.dev/mcp",
      "headers": { "Authorization": "Bearer freesea_sk_…" }
    }
  }
}

Config locations: ~/.cursor/mcp.json (Cursor), ~/.codeium/windsurf/mcp_config.json (Windsurf), .vscode/mcp.json (VS Code).

Restart your client after adding it — MCP servers are loaded at startup.

Tool	Maps to
`web_search`	`POST /v1/search` — same fields, same filters
`web_fetch`	`POST /v1/fetch` — same fields

Both take and return exactly what the REST endpoints do, validated through the same schema, so anything in the reference applies unchanged.