# Mariner

> Mariner is a native macOS REST client (SwiftUI, local-first; a free month, then a yearly subscription or a one-time lifetime purchase) with a built-in MCP server so agents can read collections, resolve environments and run requests on the user's Mac.

Docs: https://marinerhttp.dev/docs · Full text: https://marinerhttp.dev/llms-full.txt · Each page as Markdown: append .md to its URL.

## Connect an agent over MCP

- Endpoint: http://127.0.0.1:7654/mcp (loopback only; the user enables it in Settings → MCP and creates a bearer token per client). Full walkthrough: https://marinerhttp.dev/docs/mcp.md

## Getting started

- [Installation](https://marinerhttp.dev/docs/install.md): Mariner ships on the Mac App Store for macOS 15 and later. Every feature is free for a month; then it is a yearly subscription or a one-time purchase.
- [Your first request](https://marinerhttp.dev/docs/first-request.md): Mariner opens with a small sample collection so you can send something in the first ten seconds. This page walks through that request and names every part of the window you will use afterwards.

## Guides

- [Set up environments](https://marinerhttp.dev/docs/environments.md): An environment is a set of variables — base URL, tokens, headers — that you switch in one go. Define one for local, staging and production, and swap between them without touching a single request.
- [Variables and secrets](https://marinerhttp.dev/docs/variables.md): Where a value can come from, in which order Mariner looks, how to keep credentials out of exports, and how to capture values from a response so the next request already has them.
- [Collections](https://marinerhttp.dev/docs/collections.md): Workspaces hold collections; collections hold folders and requests. This page covers the sidebar — creating, moving, duplicating — and how Mariner keeps several projects apart.
- [Authentication](https://marinerhttp.dev/docs/auth.md): Basic, Bearer, API key and both common OAuth 2.0 flows, set once at the workspace, collection or folder and inherited by everything below. Credentials live in the macOS Keychain.
- [Contracts](https://marinerhttp.dev/docs/contracts.md): Derive a JSON Schema from a response that already works, and every response after it gets measured against that shape — in the response pane, in the collection runner and over MCP.
- [Runner](https://marinerhttp.dev/docs/runner.md): Run a whole collection or folder in order, stop or continue on failure, feed captured values from one request into the next, and export the report.

## Integrations

- [MCP server](https://marinerhttp.dev/docs/mcp.md): Mariner includes a local MCP server so Claude Code, Cursor, Windsurf or VS Code can read your collections, resolve environments and run requests — with the same local data, and without an API key ever leaving your Mac.
- [Import from other clients](https://marinerhttp.dev/docs/import.md): Paste a curl command, bring a Postman collection or an OpenAPI document, or open a package another Mariner exported. And the ways out — Postman, cURL, code, HAR.
- [Mac integration](https://marinerhttp.dev/docs/system.md): The parts of Mariner that reach outside the window — iCloud sync, Shortcuts and Siri, Spotlight, the request history, the app-wide proxy and the download ceiling.

## Reference

- [Keyboard shortcuts](https://marinerhttp.dev/docs/keyboard-shortcuts.md): Every shortcut Mariner binds, grouped by where you are. Press ⌘⇧/ inside the app for the same list.
- [File format](https://marinerhttp.dev/docs/file-format.md): What a Mariner export looks like on disk, so you can commit it, diff it and review it like code.
- [Pricing and the free month](https://marinerhttp.dev/docs/free-and-pro.md): Every feature is free for a month. Then Mariner is US$29.99 a year, or US$79.99 once — the same app either way. Without either, it turns read-only and nothing is deleted.

## Other

- [Support](https://marinerhttp.dev/support): how to reach the developer
- [Privacy](https://marinerhttp.dev/privacy)
- [Terms](https://marinerhttp.dev/terms)