Connect a client

Before you start

Calling tools requires approved Oceanir Enterprise integration access. Reading the public tool catalog does not require authentication. See Authentication and access before connecting.

Add the server

In your client’s MCP settings, add a remote server named oceanir with this URL:

https://mcp.oceanir.ai

Select Streamable HTTP if your client asks for a transport. With an OAuth-capable client, follow the browser sign-in and review the requested permissions.

Claude Code

claude mcp add --transport http oceanir https://mcp.oceanir.ai

Run /mcp in Claude Code, select Oceanir, and authenticate.

Codex

codex mcp add oceanir --url https://mcp.oceanir.ai
codex mcp login oceanir

For long analyses, set a tool timeout in your Codex configuration:

[mcp_servers.oceanir]
url = "https://mcp.oceanir.ai"
tool_timeout_sec = 180

Claude web and Desktop

In Settings → Connectors, add a custom connector with the server URL above, then connect your Oceanir account. Custom connector availability depends on your Claude plan and organization settings.

Other agents

Use the same URL with a Streamable HTTP MCP client. OAuth clients must support resource discovery, PKCE, and client registration. Clients with bearer-header support can use a scoped agent token. Local image paths are not server inputs: the client must supply image bytes as base64 or a public HTTPS image URL.

For clients that cannot complete browser sign-in, use a scoped agent token if your integration has been approved.

Use Orca from your agent

Try: “Check my Oceanir credits, then use Orca to analyze this image at depth 1. Show the location estimate, map link, and uncertainty.” Uploading an image to a chat does not guarantee the client can pass its bytes to MCP; a public image URL also works.

The tools geolocate_image and verify_location_claim run Orca. Depth changes the analysis level, not the model. Manta is for enterprise only; its integration details are provided during Enterprise onboarding.

Check the connection

1. Open the client’s tool list and confirm Oceanir’s tools appear.
2. Ask the client to check your Oceanir credit balance.
3. Provide an image and ask the client to analyze its location at your chosen depth.
4. Review the returned candidates and visual evidence before using the result.

The tool reference lists inputs, defaults, and the difference between locating an image and checking a claim.

Troubleshooting

Tools appear, but calls are denied

The catalog is public. Confirm that you have completed authentication and that your account has approved MCP access.

Browser sign-in is unavailable

Check whether the client supports OAuth for remote MCP servers. An approved scoped token is an alternative for clients that support bearer headers.

A call reports insufficient credits

Check the balance on the account used to connect. Review the error before retrying or purchasing credits.