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"
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:
Create a Port Account (if you don't have one):
Visit Port.io
Sign up for an account
Obtain Port Credentials:
Navigate to your Port dashboard
Go to Settings > Credentials
Save both the Client ID and Client Secret
Installation Requirements:
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.
Docker Installation
Use our official Docker image:
Additional configurations
You can pass these additional arguments for more advanced configuration:
Configuration Parameter | UVX Flag | Docker Environment Variable | Description | Default Value |
Log Level |
|
| Controls the level of log output |
|
API Validation |
|
| Controls if API schema should be validated and fail if it's not valid |
|
Usage with Claude Desktop
Go to Settings > Developer and click on "Edit config".
Edit the
claude_desktop_config.json
file and add the below configuration based on the installation method.Save the file and restart Claude.
In a new chat, check the Tools section and you'll see Port available tools.
Docker
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.
uvx
If you want to run the command from a virtual Python environment, add aPYTHONPATH
variable to the env
object with its path, e.g., /path/to/your/venv/bin/python
.
Usage with Cursor
Go to Cursor > Settings > Cursor Settings.
Click on the MCP tab, and "Add new global MCP server".
Edit the
mcp.json
file and add the below configuration based on the installation method.Save the file and return to Cursor Settings.
You will see the new Port server and its available tools.
Docker
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.
uvx
If you want to run the command from a virtual Python environment, add aPYTHONPATH
variable to the env
object with its path, e.g., /path/to/your/venv/bin/python
.
Usage with VS Code
VS Code can automatically discover MCP servers already installed in Cursor and Claude.
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 uvx quick installation
For manual installation follow these steps:
Go to the Command Palette by pressing
Cmd + Shift + P
/Ctrl + Shift + P
.Type
Preferences: Open User Settings (JSON)
and press enter.Edit the
settings.json
file and add the below configuration under themcp
>servers
.Use Copilot in Agent mode, make sure the server is running and see its available Port tools.
Docker
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.
uvx
If you want to run the command from a virtual Python environment, add aPYTHONPATH
variable to the env
object with its path, e.g., /path/to/your/venv/bin/python
.
Available Tools
Blueprint Tools
get_blueprints
Retrieve a list of all blueprints from Port
Optional inputs:
detailed
(boolean, default: false): Return complete schema details for each blueprint
Returns: Formatted text representation of all available blueprints
get_blueprint
Retrieve information about a specific blueprint by its identifier
Required inputs:
blueprint_identifier
(string): The unique identifier of the blueprint to retrieve
Optional inputs:
detailed
(boolean, default: true): Return complete schema details
create_blueprint
Create a new blueprint in Port
Required inputs:
Various fields including identifier, title, properties, etc.
Returns: The created blueprint object
update_blueprint
Update an existing blueprint
Required inputs:
identifier
(string): The unique identifier of the blueprint to updateVarious fields to update
Returns: The updated blueprint object
delete_blueprint
Delete a blueprint from Port
Required inputs:
blueprint_identifier
(string): The unique identifier of the blueprint to delete
Returns: Success status
Entity Tools
get_entities
Retrieve all entities for a given blueprint
Required inputs:
blueprint_identifier
(string): The identifier of the blueprint to get entities for
Optional inputs:
detailed
(boolean, default: false): Return complete entity details including properties
get_entity
Retrieve information about a specific entity
Required inputs:
blueprint_identifier
(string): The identifier of the blueprint the entity belongs toentity_identifier
(string): The unique identifier of the entity to retrieve
Optional inputs:
detailed
(boolean, default: true): Return complete entity details
create_entity
Create a new entity for a specific blueprint
Required inputs:
blueprint_identifier
(string): The identifier of the blueprint to create the entity forentity
(object): The entity data following the blueprint schema
update_entity
Update an existing entity
Required inputs:
blueprint_identifier
(string): The identifier of the blueprint the entity belongs toentity_identifier
(string): The unique identifier of the entity to updateentity
(object): The updated entity data
delete_entity
Delete an entity
Required inputs:
blueprint_identifier
(string): The identifier of the blueprint the entity belongs toentity_identifier
(string): The unique identifier of the entity to delete
Optional inputs:
delete_dependents
(boolean, default: false): If true, also deletes all dependencies
Scorecard Tools
get_scorecards
Retrieve all scorecards from Port
Optional inputs:
detailed
(boolean, default: false): Return complete scorecard details
get_scorecard
Retrieve information about a specific scorecard by its identifier
Required inputs:
scorecard_id
(string): The unique identifier of the scorecard to retrieveblueprint_id
(string, optional): The identifier of the blueprint the scorecard belongs to
create_scorecard
Create a new scorecard for a specific blueprint
Required inputs:
blueprint_id
(string): The identifier of the blueprint to create the scorecard foridentifier
(string): The unique identifier for the new scorecardtitle
(string): The display title of the scorecardlevels
(list): List of levels for the scorecard
Optional inputs:
rules
(list): List of rules for the scorecarddescription
(string): Description for the scorecard
update_scorecard
Update an existing scorecard
Required inputs:
blueprint_identifier
(string): The identifier of the blueprint the scorecard belongs toscorecard_identifier
(string): The unique identifier of the scorecard to updateVarious fields to update (title, levels, rules, etc.)
Returns: The updated scorecard object
delete_scorecard
Delete a scorecard from Port
Required inputs:
blueprint_identifier
(string): The identifier of the blueprint the scorecard belongs toscorecard_identifier
(string): The unique identifier of the scorecard to delete
Returns: Success status
AI Agents Tool
invoke_ai_agent
Invoke a Port AI agent with a specific prompt
Required inputs:
prompt
(string): The prompt to send to the AI agent
Returns: Invocation status and message from the AI agent
Feedback and Roadmap
We're continuously improving Port MCP and would love to hear from you! Please share your feedback and feature requests on our roadmap page.
Troubleshooting
If you encounter authentication errors, verify that:
Your Port credentials are correctly set in the arguments.
You have the necessary permissions.
The credentials are properly copied to your configuration.
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
An MCP server that enables Claude to interact with Port.io's AI agent, allowing users to trigger the agent with prompts and receive structured responses including status, output, and action items.
Related Resources
Related MCP Servers
- -securityFlicense-qualityAn MCP server that allows AI assistants like Claude to execute terminal commands on the user's computer and return the output, functioning like a terminal through AI.Last updated -60
- AsecurityFlicenseAqualityA Machine Context Protocol server that enables Claude AI to interact with tools through a structured communication interface, following standard MCP patterns with server initialization and stdio transport.Last updated -6781
- AsecurityAlicenseAqualityMCP server that provides Claude AI assistants with the ability to search the web, get news, and perform research using the You.com API.Last updated -42MIT License
- -securityFlicense-qualityA high-speed MCP server that enables AI assistants like Claude to interact with local filesystems, manage Git repositories, and provide interactive experiences through a standardized JSON-based protocol.Last updated -5