Labsco
port-labs logo

Port MCP Server

β˜… 16

from port-labs

An MCP server for Port.io that enables advanced automations and natural language interactions for developers and AI applications.

πŸ”₯πŸ”₯βœ“ VerifiedFreeAdvanced setup

⚠️ 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.

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

Blueprint Tools

  1. 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
  2. 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
  3. create_blueprint

    • Create a new blueprint in Port
    • Required inputs:
      • Various fields including identifier, title, properties, etc.
    • Returns: The created blueprint object
  4. update_blueprint

    • Update an existing blueprint
    • Required inputs:
      • identifier (string): The unique identifier of the blueprint to update
      • Various fields to update
    • Returns: The updated blueprint object
  5. 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

  1. 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
  2. get_entity

    • Retrieve information about a specific entity
    • Required inputs:
      • blueprint_identifier (string): The identifier of the blueprint the entity belongs to
      • entity_identifier (string): The unique identifier of the entity to retrieve
    • Optional inputs:
      • detailed (boolean, default: true): Return complete entity details
  3. create_entity

    • Create a new entity for a specific blueprint
    • Required inputs:
      • blueprint_identifier (string): The identifier of the blueprint to create the entity for
      • entity (object): The entity data following the blueprint schema
  4. update_entity

    • Update an existing entity
    • Required inputs:
      • blueprint_identifier (string): The identifier of the blueprint the entity belongs to
      • entity_identifier (string): The unique identifier of the entity to update
      • entity (object): The updated entity data
  5. delete_entity

    • Delete an entity
    • Required inputs:
      • blueprint_identifier (string): The identifier of the blueprint the entity belongs to
      • entity_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

  1. get_scorecards

    • Retrieve all scorecards from Port
    • Optional inputs:
      • detailed (boolean, default: false): Return complete scorecard details
  2. get_scorecard

    • Retrieve information about a specific scorecard by its identifier
    • Required inputs:
      • scorecard_id (string): The unique identifier of the scorecard to retrieve
      • blueprint_id (string, optional): The identifier of the blueprint the scorecard belongs to
  3. create_scorecard

    • Create a new scorecard for a specific blueprint
    • Required inputs:
      • blueprint_id (string): The identifier of the blueprint to create the scorecard for
      • identifier (string): The unique identifier for the new scorecard
      • title (string): The display title of the scorecard
      • levels (list): List of levels for the scorecard
    • Optional inputs:
      • rules (list): List of rules for the scorecard
      • description (string): Description for the scorecard
  4. update_scorecard

    • Update an existing scorecard
    • Required inputs:
      • blueprint_identifier (string): The identifier of the blueprint the scorecard belongs to
      • scorecard_identifier (string): The unique identifier of the scorecard to update
      • Various fields to update (title, levels, rules, etc.)
    • Returns: The updated scorecard object
  5. delete_scorecard

    • Delete a scorecard from Port
    • Required inputs:
      • blueprint_identifier (string): The identifier of the blueprint the scorecard belongs to
      • scorecard_identifier (string): The unique identifier of the scorecard to delete
    • Returns: Success status

AI Agents Tool

  1. 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

Local Development

For developing and testing new functionalities locally before publishing a new version, you can configure your MCP client (e.g., Cursor) to use your local cloned repository.