MCP Server

Access Nautilus Trader MCP Server with authentication and integration guide

MCP Server

Overview

The Nautilus Trader MCP Server provides programmatic access to data through the Model Context Protocol. Use this guide to set up authentication and integrate the MCP Server into your applications.

Getting started

1. Subscribe to MCP server

Visit the Subscriptions page and select the MCP Server product to get started. See Subscriptions guide for detailed steps on purchasing and managing your subscription.

2. Generate an API key

Navigate to the API Keys section and generate a new API key if you haven't already. Your API key will start with nt_ prefix. See API Keys guide for detailed steps on creating, rotating, and managing your keys.

3. Authenticate your connection

Use your API key to authenticate all MCP requests as shown below.

MCP authentication

Setting up MCP authentication

After subscribing to an MCP Server plan, you can create an API key that serves as your authentication credential. This key authenticates all MCP connections.

Authenticating with bearer token

You can try out MCP using this configuration:

Claude Code:

claude mcp add --transport http nautilus-trader-mcp https://mcp-staging.nautilustrader.io/mcp --header "Authorization: Bearer nt_your_api_key_here"

Codex:

Add this configuration to the bottom of your ~/.codex/config.toml:

[mcp_servers."nautilus-trader-mcp"]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp-staging.nautilustrader.io/mcp",
  "--allow-http",
  "--header",
  "Authorization:Bearer nt_your_api_key_here",
]

Other Clients:

"mcpServers": {
  "nautilus-trader-mcp": {
    "type": "http",
    "url": "https://mcp-staging.nautilustrader.io/mcp",
    "headers": {
      "Authorization": "Bearer nt_your_api_key_here"
    }
  }
}

Replace nt_your_api_key_here with your actual API key from the API Keys section.

API key management

Your MCP API key can be found in the API Keys section of your account:

  • Create - Generate a new API key for MCP authentication
  • Rotate - Regenerate your key for security (recommended periodically)
  • Revoke - Disable a key immediately if compromised
  • Last Used - Monitor when your key was last accessed

Authentication flow

  1. Subscribe to an MCP Server plan
  2. Navigate to API Keys section
  3. Generate or copy your existing API key (starts with nt_)
  4. Use the key in the Authorization: Bearer header for all MCP requests
  5. Keep your key secure and rotate it regularly

Security best practices

  • Never expose your API key in client-side code or version control
  • Use environment variables to store your authentication token
  • Rotate keys regularly to limit exposure time
  • Monitor API usage through your dashboard
  • Revoke immediately if your key is compromised
  • Keep your key confidential and don't share it across teams or projects

Troubleshooting

Authentication issues

Invalid or Expired API Key

  • Verify your API key starts with nt_ prefix
  • Check that the key hasn't been rotated or revoked
  • Visit API Keys section to generate a new key if needed
  • Ensure the key is passed in the Authorization: Bearer header

401 Unauthorized Errors

  • Confirm your subscription is active in the Subscriptions page
  • Verify your API key is correct and not expired
  • Check that you're using the correct API endpoint

Connection Failures

  • Ensure your network allows outbound connections to mcp-staging.nautilustrader.io
  • Test connectivity with curl from your environment
  • Contact support at support@nautilustrader.io if issues persist

Getting help

For MCP Server issues:

  • Review your API Keys configuration
  • Check your Subscriptions status
  • Contact support at support@nautilustrader.io

Best practices

Security

  • Never expose your API key in client-side code or version control
  • Use environment variables to store your authentication token
  • Rotate keys regularly to limit exposure time
  • Revoke immediately if your key is compromised

For billing, subscription management, and payment information, see the Billing and Subscriptions guides.