⚠️ This Repository is No Longer Maintained

[!WARNING] This repository has been deprecated and is no longer actively maintained or supported. No further updates, bug fixes, or security patches will be provided.

Migrate to Port's Remote MCP Server

We strongly encourage all users to migrate to Port's Remote MCP Server, which is the actively maintained and supported solution.

The Remote MCP Server offers full feature parity and ongoing improvements backed by the Port team.

---

Port MCP Server

The Port IO MCP server is a Model Context Protocol (MCP) server, enabling advanced automations and natual language interactions for developers and AI applications.

What You Can Do With Port MCP

Find Information Quickly

• Get entity details - "Who is the owner of service X?"
• Check on-call status - "Who is on call right now?"
• Get catalog insights - "How many services do we have in production?"

Analyze Scorecards

• Identify weak points - "Which services are failing for the gold level and why?"
• Get compliance status - "Show me all services that don't meet our security requirements"
• Improve quality - "What do I need to fix to reach the next scorecard level?"

Create Resources

• Build scorecards - "Create a new scorecard called 'Security Posture' with levels Basic, Silver, and Gold"
• Define rules - "Add a rule that requires services to have a team owner to reach the Silver level"
• Setup quality gates - "Create a rule that checks if services have proper documentation"

Manage Permissions & RBAC

• Fetch action permissions - "What are the current permission settings for this action?"
• Update action policies - "Configure approval workflows for the deployment action"
• Configure dynamic permissions - "Set up team-based access control for this action"

We're continuously expanding Port MCP's capabilities. Have a suggestion? We'd love to hear your feedback on our roadmap!

Installation

Prerequisites

Before you begin, you'll need:

1. Create a Port Account (if you don't have one):

   • Visit Port.io
   • Sign up for an account

2. Obtain Port Credentials:

   • Navigate to your Port dashboard
   • Go to Settings > Credentials
   • Save both the Client ID and Client Secret

3. Installation Requirements:

   • Either Docker installed on your system
   • OR uvx package manager installed

[!NOTE] You will also need to provide your Port region, which is either EU or US. If not provided, the default is EU.

Installation methods

Port MCP Server can be installed using two methods:

Package Installation (uvx)

Use our official Port MCP server package with uvx for easy installation and management.

Step-by-Step Installation Guide

1. Create a Python Virtual Environment (Recommended)

   python -m venv venv
   

2. Activate the Virtual Environment

   # On Linux/macOS:
   source venv/bin/activate
   
   # On Windows:
   venv\Scripts\activate
   

3. Install the UV Package Manager

   # Using Homebrew (macOS/Linux):
   brew install uv
   
   # Or using pip:
   pip install uv
   

4. Verify UV Installation

   which uv
   

5. Set Required Environment Variables

   export PORT_CLIENT_ID="your_port_client_id"
   export PORT_CLIENT_SECRET="your_port_client_secret"
   export PORT_REGION="EU"  # or "US"
   

6. Set Python Path (if using virtual environment)

   export PYTHONPATH="/path/to/your/venv/bin/python"
   

7. Run the MCP Server

   uvx mcp-server-port --client-id your_port_client_id --client-secret your_port_client_secret --region EU --log-level DEBUG
   

8. Verify Server is Running You should start seeing logs from the server. You can also check the log file:

   cat /tmp/port-mcp.log
   

Docker Installation

Use our official Docker image:

docker pull ghcr.io/port-labs/port-mcp-server:latest

See below for detailed instructions on each MCP client.

Additional configurations

You can pass these additional arguments for more advanced configuration:

Usage with Claude Desktop

1. Go to Settings > Developer and click on "Edit config".
2. Edit the claude_desktop_config.json file and add the below configuration based on the installation method.
3. Save the file and restart Claude.
4. In a new chat, check the Tools section and you'll see Port available tools.

Docker

[!TIP] Consider using the full path to Docker (e.g., /usr/local/bin/docker) instead of just docker. You can find this path by running which docker in your terminal. Using the full path helps avoid PATH resolution issues and ensures consistent behavior across different shell environments.

{
  "mcpServers": {
    "port": {
      "command": "docker",
      "args": [
               "run",
                "-i",
                "--rm",
                "-e",
                "PORT_CLIENT_ID",
                "-e",
                "PORT_CLIENT_SECRET",
                "-e",
                "PORT_REGION",
                "-e",
                "PORT_LOG_LEVEL",
                "ghcr.io/port-labs/port-mcp-server:latest"
              ],
              "env": {
                "PORT_CLIENT_ID": "<PORT_CLIENT_ID>",
                "PORT_CLIENT_SECRET": "<PORT_CLIENT_SECRET>",
                "PORT_REGION": "<PORT_REGION>",
                "PORT_LOG_LEVEL": "<PORT_LOG_LEVEL>"
              }
    }
  }
}

uvx

[!NOTE] If you want to run the command from a virtual Python environment, add a PYTHONPATH variable to the env object with its path, e.g., /path/to/your/venv/bin/python.

{
  "mcpServers": {
    "Port": {
          "command": "uvx",
          "args": [
              "mcp-server-port@0.2.8",
              "--client-id",
              "<PORT_CLIENT_ID>",
              "--client-secret",
              "<PORT_CLIENT_SECRET>",
              "--region",
              "<PORT_REGION>"
          ],
          "env": {
              "PORT_CLIENT_ID": "<PORT_CLIENT_ID>",
              "PORT_CLIENT_SECRET": "<PORT_CLIENT_SECRET>",
              "PORT_REGION": "<PORT_REGION>",
              "PYTHONPATH": "/Users/matangrady/.venv-port-mcp/bin/python"
          }
      }
  }
}

Usage with Cursor

1. Go to Cursor > Settings > Cursor Settings.
2. Click on the MCP tab, and "Add new global MCP server".
3. Edit the mcp.json file and add the below configuration based on the installation method.
4. Save the file and return to Cursor Settings.
5. You will see the new Port server and its available tools.

Docker

[!TIP] Consider using the full path to Docker (e.g., /usr/local/bin/docker) instead of just docker. You can find this path by running which docker in your terminal. Using the full path helps avoid PATH resolution issues and ensures consistent behavior across different shell environments.

{
  "mcpServers": {
    "port": {
      "command": "docker",
      "args": [
               "run",
                "-i",
                "--rm",
                "-e",
                "PORT_CLIENT_ID",
                "-e",
                "PORT_CLIENT_SECRET",
                "-e",
                "PORT_REGION",
                "-e",
                "PORT_LOG_LEVEL",
                "ghcr.io/port-labs/port-mcp-server:latest"
              ],
              "env": {
                "PORT_CLIENT_ID": "<PORT_CLIENT_ID>",
                "PORT_CLIENT_SECRET": "<PORT_CLIENT_SECRET>",
                "PORT_REGION": "<PORT_REGION>",
                "PORT_LOG_LEVEL": "<PORT_LOG_LEVEL>"
              }
    }
  }
}

uvx

[!NOTE] If you want to run the command from a virtual Python environment, add a PYTHONPATH variable to the env object with its path, e.g., /path/to/your/venv/bin/python.

{
  "mcpServers": {
    "Port": {
          "command": "uvx",
          "args": [
              "mcp-server-port@0.2.8",
              "--client-id",
              "<PORT_CLIENT_ID>",
              "--client-secret",
              "<PORT_CLIENT_SECRET>",
              "--region",
              "<PORT_REGION>"
          ],
          "env": {
              "PORT_CLIENT_ID": "<PORT_CLIENT_ID>",
              "PORT_CLIENT_SECRET": "<PORT_CLIENT_SECRET>",
              "PORT_REGION": "<PORT_REGION>",
              "PYTHONPATH": "/Users/matangrady/.venv-port-mcp/bin/python"
          }
      }
  }
}

Usage with VS Code

[!TIP] VS Code can automatically discover MCP servers already installed in Cursor and Claude.

[!NOTE] For quick installation, use the one-click install buttons and select where to add the MCP configuration. Make sure to replace the placeholders with your Port credentials.

[Docker quick installation](https://insiders.vscode.dev/redirect/mcp/install?name=port&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22-e%22%2C%22PORT_CLIENT_ID%22%2C%22-e%22%2C%22PORT_CLIENT_SECRET%22%2C%22-e%22%2C%22PORT_REGION%22%

---