Skip to main content

Cursor

Connect Cursor to the Autena MCP server to query shipment data from within your editor.

Configuration​

Cursor supports remote MCP servers natively. Open Cursor Settings and navigate to MCP Servers, or edit your project's .cursor/mcp.json:

{
  "mcpServers": {
    "autena": {
      "url": "https://api.autena.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer atn_YOUR_API_KEY",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

Replace atn_YOUR_API_KEY with your actual API key.

Using a JWT instead​

If you've exchanged your OAuth credentials for a JWT via the Client Credentials Grant, you can pass the JWT directly:

{
  "mcpServers": {
    "autena": {
      "url": "https://api.autena.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer eyJhbGci...",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

Note: JWTs obtained via the Client Credentials Grant have a limited lifetime and this method does not provide a token refresh flow. You will need to manually replace the token when it expires. For automated refresh, implement the OAuth flow programmatically or use an API key instead.

See Authentication for how to obtain a JWT from your client_id and client_secret.

Usage​

In Cursor's chat, the Autena tools will be available for the agent to call. Try asking:

  • "Check if any of our shipments are delayed"
  • "What's the status of BOL MAEU123456789?"
  • "Find shipments from Shanghai arriving this week"