Connect Cursor to Terminal49

Connect Cursor to the Terminal49 MCP server so its AI agent can answer questions with live container and shipment tracking data.

No API key required. The Terminal49 MCP server supports OAuth 2.1. When you connect, Cursor opens a browser sign-in page — log in with your Terminal49 credentials and you’re done.

Add the server

Add the Terminal49 server

The fastest way is the one-click install button — it opens Cursor with the Terminal49 server configuration pre-filled; just confirm to install:

Alternatively, add the server manually to .cursor/mcp.json in your project (or ~/.cursor/mcp.json to make it available in every project):

{
  "mcpServers": {
    "terminal49": {
      "url": "https://mcp.terminal49.com"
    }
  }
}

You can also add it from the UI: Cursor Settings → MCP → Add new MCP server, using the same URL.

Cursor detects that the server requires authentication and shows a Needs login / Connect action next to it in Cursor Settings → MCP. Click it — your browser opens the Terminal49 sign-in page. Log in and approve access. Cursor stores and refreshes the tokens automatically.

Use it in a chat

Open the agent chat and ask:

“Using Terminal49, search for container CAIU1234567 and summarize its status.”

Alternative: install the Terminal49 plugin

Instead of adding the MCP server directly, you can install the Terminal49 plugin, which configures the same MCP connection and adds a container-tracking skill that teaches Cursor’s agent how to choose and sequence the Terminal49 tools. See the Agent plugins guide for install steps and details.

API key alternative

If you prefer a fixed credential (for example on a shared machine where the browser flow isn’t practical), create an API key in the developer portal and pass it as a header instead:

{
  "mcpServers": {
    "terminal49": {
      "url": "https://mcp.terminal49.com",
      "headers": {
        "Authorization": "Token YOUR_API_KEY"
      }
    }
  }
}

Test your connection

Ask the Cursor agent:

“List the tools available in the Terminal49 MCP server and what they’re for.”

It should list tools such as search_container, track_container, and get_container. See the tools reference for the full list, and Test Numbers for containers you can use during development.

Troubleshooting

Symptom	How to fix
Server shows as disconnected	Confirm the URL is exactly `https://mcp.terminal49.com` (no path), then toggle the server off and on in Cursor Settings → MCP
Sign-in window never opens	Update Cursor to the latest version, then retry the Connect action
`401 Unauthorized`	Re-run the login from Cursor Settings → MCP, or check the `Authorization: Token YOUR_API_KEY` header if you use an API key
Tools list is empty	Restart Cursor so it reloads `mcp.json`

Agent plugins – Terminal49 plugin with the container-tracking skill
MCP Overview – Tools, prompts, and resources reference
MCP Server Quickstart – Full setup, including API-key and local stdio options
Other MCP clients – Generic configuration for any client

​Add the server

​Alternative: install the Terminal49 plugin

​API key alternative

​Test your connection

​Troubleshooting

​Related guides

Add the server

Alternative: install the Terminal49 plugin

API key alternative

Test your connection

Troubleshooting

Related guides