Available tools
The Port MCP Server exposes different sets of tools based on your role and use case. The tools you see will depend on your permissions in Port.
- Developer
- Builder
Developers are typically users who consume and interact with the developer portal - querying services, running actions, and analyzing data. These tools help you get information and execute approved workflows.
list_blueprints
get_blueprint
get_entities
get_entity
get_scorecards
get_scorecard
list_actions
get_action
track_action_run
run_*
Dynamicget_action_permissions
ask_port_docs
search_port_docs_sources
describe_user_details
Builders are platform engineers or admins who design and configure the developer portal - creating blueprints, setting up scorecards, and managing the overall structure. These tools help you build and maintain the portal.
Builders have access to all the tools available to Developers, plus additional management tools for creating and configuring the portal.
create_blueprint
list_blueprints
get_blueprint
update_blueprint
delete_blueprint
create_entity
get_entities
get_entity
update_entity
delete_entity
create_scorecard
get_scorecards
get_scorecard
update_scorecard
delete_scorecard
create_action
list_actions
get_action
update_action
delete_action
track_action_run
run_*
Dynamicget_action_permissions
update_action_permissions
ask_port_docs
search_port_docs_sources
describe_user_details
Select which tools to useโ
By default, when you open a chat with Port MCP, all available tools (based on your permissions) are loaded and ready to use. However, you can customize which tools are available if you want to focus on specific workflows.
For example, if you only want to query data from Port without building or modifying anything, you can limit the tools to just the read-only ones. This helps reduce complexity and ensures you don't accidentally make changes.
- Cursor
- VSCode
- Claude
In Cursor, you can customize which tools are available through the UI after connecting to Port MCP. Once connected, you can select specific tools as shown below.
In VSCode, you can choose the tools through the UI after connecting to Port MCP.
When creating a custom connector in Claude, you can specify exactly which tools to expose instead of enabling everything.
Refer to the Claude custom connector documentation for detailed instructions.