Connect to an AI client

What your agent gets

Mariner Tools provides an MCP server. MCP, the Model Context Protocol, is an open standard that lets AI assistants use external tools. When you connect it, a compatible AI assistant or agent gains access to the Mariner Tools navigation capabilities and can find and call those tools when a conversation needs them, for example to convert coordinates or calculate a distance.

https://marinergps.tools/mcp

Manual setup

Most AI clients follow the same pattern. The wording differs between products, but the steps are:

1. Open the MCP, connectors or integrations settings in your AI client.
2. Choose to add a custom or remote MCP server.
3. Enter the Mariner Tools MCP URL shown above.
4. Continue or connect.
5. Your browser opens the Mariner Tools authorization page.
6. Sign in to your Mariner Tools account, or create one for free.
7. Review the requested permissions and choose Allow access.
8. Return to your AI client.
9. Confirm that Mariner Tools appears as connected.
10. Ask a navigation question, for example the distance between two positions, to verify the connection.

Troubleshooting

The browser authorization page did not open

Look for a link or button in the client such as Connect, Authorize or Sign in, and check that a pop-up was not blocked. Removing and re-adding the server usually restarts the flow.

The client reports that authentication is required

The connection was added but not authorized yet. Trigger the client's sign-in or reconnect action so the authorization page opens.

Authorization was denied

If you chose Deny, the client cannot use Mariner Tools. Reconnect and choose Allow access to grant it.

Access was revoked

If you removed the application from your account page, its connection stops working. Reconnect from the client and authorize it again.

The client does not support automatic authorization

Some clients cannot run the browser sign-in flow. Use the manual setup with an API key below.

The client requires manual configuration

Clients configured through a JSON file rather than a settings screen can use the manual setup below.

Connected, but no tools appear

Refresh the client's tool list or restart the client. If tools still do not appear, remove the server and connect again.

Advanced: manual setup with an API key

For programmatic clients, scripts, or clients without browser authorization, Mariner Tools also accepts API keys on the MCP server. Create a key on your account page and reference it in the client configuration:

{
  "mcpServers": {
    "mariner-tools": {
      "url": "https://marinergps.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Both sign-in methods reach the same tools with the same permissions model.