home / mcp / marlo mcp server

Marlo MCP Server

Async Python client for interacting with the Marlo MCP server to access vessel data, voyages, financials, rates, and more.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "core-marlo-marlo-mcp": {
      "command": "uvx",
      "args": [
        "marlo-mcp"
      ],
      "env": {
        "MARLO_MCP_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can interact with the Marlo MCP server using an async Python client that authenticates with an API key and retrieves vessel data along with many other maritime finance and operations endpoints. This MCP server setup lets you run a local or remote MCP client and access a wide range of tools to manage voyages, banking, loans, analytics, and compliance within Marlo.

How to use

Choose your MCP client workflow to connect to Marlo MCP. You can run the local MCP server wrapper provided by uvx and pass your API key as an environment variable, then use the Python client to perform authenticated requests. Start by configuring the MCP connection, then call the available tools to fetch vessel data, voyages, invoices, market rates, and more. Each tool returns structured data you can use to integrate Marlo MCP into your own workflows, dashboards, or reporting pipelines.

How to install

Prerequisites you need before getting started:

Python 3.12 or newer
uvx (to run MCP commands)
internet access to install dependencies

Install and set up the MCP client environment. Use the concrete runtime command shown to start the MCP server for Marlo.

{
  "mcpServers": {
    "marlo-mcp": {
      "command": "uvx",
      "args": ["marlo-mcp"],
      "env": {
        "MARLO_MCP_API_KEY": "<your-api-key>"
      }
    }
  }
}

To install and interact with Claude Desktop (as an example MCP client), run the following command and provide your API key when prompted:

mcp install PATH/TO/main.py -v MARLO_MCP_API_KEY=<your-api-key>

Additional notes

This MCP setup is designed for asynchronous operation and requires your API key for authenticated access. The environment variable MARLO_MCP_API_KEY must be set in the MCP server configuration or your shell when invoking the MCP client. The Marlo MCP client exposes a broad set of tools to retrieve vessel data, voyages, financial documents, market rates, sanctions information, and more.

Configuration and security

Configure your MCP server entry to securely provide the API key and ensure only authorized systems can access Marlo MCP endpoints. Store API keys in a secure vault or environment management system and rotate keys regularly. Avoid exposing the API key in logs or code repositories.

Troubleshooting

If you encounter connection issues, verify that MARLO_MCP_API_KEY is correctly set in the environment for the MCP process. Check that the uvx command is available in your PATH and that the marlo-mcp service is reachable. Confirm network access and that the MCP server is running before issuing tool requests.

Examples of supported actions

You can retrieve vessel data, fetch voyage details, obtain profit and loss reports, access market rates, examine invoices and bills, and query sanctions and compliance information using the available tools.

Tools overview

The Marlo MCP client provides a comprehensive set of tools to access data and operations. Each tool corresponds to a specific API endpoint or data view and returns structured results that you can use in your applications.

Available tools

get_vessels

Fetch all vessels with minimal details to quickly build overviews and dashboards.

get_vessel_details

Retrieve full details for a specific vessel by identifier.

create_vessel

Create a new vessel record in the MCP system.

search_ports

Search and filter ports to find suitable locations for voyages or cargo operations.

search_cargos

Query available cargos to plan shipments or charters.

get_all_charter_specialists

List all charter specialists available for engagement.

search_charterer_contacts

Find contact information for charterers.

get_all_voyages

List all voyages with high-level details.

get_voyage_details

Get full details for a specific voyage.

get_voyage_profit_and_loss

Compute profit and loss for a voyage.

get_all_estimates_sheet

Retrieve all estimates sheets used in planning.

get_estimate_sheet_details

Get details for a single estimate sheet.

get_all_cargo_books

List all cargo books in the system.

get_cargo_book_details

Get details for a specific cargo book.

list_all_vessel_fixtures

List all vessel fixtures.

get_vessel_fixture_details

Get details for a specific vessel fixture.

get_voyage_contacts

Fetch voyage-related contacts.

get_voyage_contacts_financial_details

Get financial details for voyage contacts.

get_vessel_fixture_contacts

Retrieve contacts for a vessel fixture.

get_vessel_fixture_contacts_financial_details

Get financial details for contacts of a vessel fixture.

get_invoice_details

Fetch details for an invoice.

get_bill_details

Fetch details for a bill.

voyage_port_disbursements

Retrieve voyage port disbursement data.

get_voyage_laytime

Get laytime information for a voyage.

list_all_customers

List all customers in the MCP system.

list_all_vendors

List all vendors in the MCP system.

list_all_lendors

List all lendors in the MCP system.

get_customer_details

Get details for a specific customer.

get_vendor_details

Get details for a specific vendor.

list_all_bills

List all bills in the system.

list_all_invoices

List all invoices in the system.

get_journal_entries

Retrieve journal entries.

list_all_vendor_credits

List all vendor credits.

get_vendor_credit_details

Get details for a vendor credit.

list_all_credit_notes

List all credit notes.

get_credit_note_details

Get details for a credit note.

list_all_external_loans

List all external loans.

get_external_loan_details

Get details for an external loan.

list_all_marlo_loans

List all Marlo loans.

get_market_rates

List all market rates.

get_market_rate_details

Get details for a specific market rate.

get_covenant

Retrieve covenant information.

get_credit_score

Get credit score metrics.

get_interest_rates

List all interest rates.

list_all_sanctions_case_manager

List all sanctions case manager entries.

get_sanctions_case_manager_details

Get details for a sanctions case manager.

search_sanctions

Search sanctions records.

search_individual_sanction

Search for individual sanctions.

list_all_bank_accounts

List all bank accounts.

list_all_bank_transactions

List all bank transactions.

get_profit_loss

Get profit and loss data.

get_balance_sheet

Get balance sheet data.

get_global_search_vessel_list

Get a global vessel list search.

get_vessel_valuation

Get vessel valuation data.

list_approval_transactions

List approval transactions.

get_global_account_currency_balance

Get balance by global account currency.

list_all_global_accounts

List all global accounts.

list_all_payouts

List all payouts.

get_payout_details

Get details for a payout.

get_company_valuation

Get company valuation data.

get_operational_cashflow

Get operational cashflow data.

get_cashbalance_streams

Get cashbalance streams data.

get_all_borrowers_summary_for_lender

Summarize borrowers and loan statistics for lenders.

get_borrower_financial_details_for_lender

Provide comprehensive financial analysis and loan details for a borrower.