Servers

This guide provides information about available Model Context Protocol (MCP) servers, their capabilities, and how to set them up with Kiro.

Warning

Only add MCP servers from trusted sources, and review all applicable server licensing information and documentation. Kiro is not responsible for any third-party MCP servers or other packages.

AWS Documentation Server

The AWS Documentation server provides access to AWS documentation, search capabilities, and content recommendations.

Capabilities

Search AWS documentation across all services
Read documentation pages in markdown format
Get content recommendations related to specific documentation pages

Setup Instructions

Prerequisites

Install uv from Astral:

bash

# On macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows PowerShell
irm https://astral.sh/uv/install.ps1 | iex

Install Python 3.10 or newer:
bash
```
uv python install 3.10
```

Configuration

For macOS/Linux:

json

{
  "mcpServers": {
    "aws-docs": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

For Windows:

json

{
  "mcpServers": {
    "aws-docs": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.aws-documentation-mcp-server@latest",
        "awslabs.aws-documentation-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

Available Tools

Tool Name	Description
`mcp_aws_docs_search_documentation`	Search AWS documentation for specific topics
`mcp_aws_docs_read_documentation`	Read AWS documentation pages in markdown format
`mcp_aws_docs_recommend`	Get content recommendations related to a documentation page

Usage Examples

# Search for information about S3 bucket policies
Search AWS documentation for S3 bucket policies

# Read specific documentation
Read the AWS Lambda function URLs documentation

# Get recommendations
Find related content to AWS ECS task definitions

GitHub MCP Server

The GitHub MCP server allows Kiro to interact with GitHub repositories, issues, and pull requests.

Capabilities

Access repository information including files, commits, and branches
Create and manage issues and pull requests
Search repositories for specific content

Setup Instructions

Warning

The previously recommended @modelcontextprotocol/server-github package has been archived. GitHub now recommends using their official Docker-based MCP server.

Prerequisites

Install Docker if not already installed:
- Docker Desktop for macOS and Windows
- Docker Engine for Linux
Create a GitHub Personal Access Token:
- Go to GitHub Settings > Developer settings > Personal access tokens (fine-grained)
- Generate a new token with permissions that fit the tools you need

Configuration

Follow these steps from the official GitHub documentation:

Create a .kiro/settings/mcp.json file in your workspace directory (or edit if it already exists)
Add this configuration:

json

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "-e", 
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

For more detailed installation instructions, refer to the official GitHub MCP Server documentation.

Common Tools

The GitHub MCP server provides a comprehensive set of tools for interacting with GitHub. Here are some of the most commonly used tools organized by category:

Repository Tools

Tool Name	Description
`search_repositories`	Search for GitHub repositories
`get_file_contents`	Get the contents of a file from a repository
`search_code`	Search for code in repositories
`list_branches`	List branches in a repository
`create_branch`	Create a new branch in a repository

Issue Tools

Tool Name	Description
`list_issues`	List issues in a repository
`get_issue`	Get details of a specific issue
`create_issue`	Create a new issue in a repository
`update_issue`	Update an existing issue
`add_issue_comment`	Add a comment to an issue

Pull Request Tools

Tool Name	Description
`list_pull_requests`	List pull requests in a repository
`get_pull_request`	Get details of a specific pull request
`create_pull_request`	Create a new pull request
`get_pull_request_files`	Get files changed in a pull request
`merge_pull_request`	Merge a pull request

Actions and Workflows

Tool Name	Description
`list_workflows`	List workflows in a repository
`list_workflow_runs`	List workflow runs for a specific workflow
`get_workflow_run`	Get details of a specific workflow run

Code Security

Tool Name	Description
`list_code_scanning_alerts`	List code scanning alerts in a repository
`get_code_scanning_alert`	Get details of a specific code scanning alert

Dependabot

Tool Name	Description
`list_dependabot_alerts`	List Dependabot alerts in a repository
`get_dependabot_alert`	Get details of a specific Dependabot alert

Discussions

Tool Name	Description
`list_discussions`	List discussions in a repository
`get_discussion`	Get details of a specific discussion
`get_discussion_comments`	Get comments from a discussion

Notifications

Tool Name	Description
`list_notifications`	List GitHub notifications
`get_notification_details`	Get detailed information for a specific notification
`mark_all_notifications_read`	Mark all notifications as read

Available Toolsets

The GitHub MCP server organizes its functionality into toolsets that can be enabled or disabled as needed. By default, all toolsets are enabled. Here's an overview of the available toolsets:

Toolset	Description
`context`	Strongly recommended: Tools that provide context about the current user and GitHub context you are operating in
`actions`	GitHub Actions workflows and CI/CD operations
`code_security`	Code security related tools, such as GitHub Code Scanning
`dependabot`	Dependabot tools
`discussions`	GitHub Discussions related tools
`experiments`	Experimental features that are not considered stable yet
`issues`	GitHub Issues related tools
`notifications`	GitHub Notifications related tools
`orgs`	GitHub Organization related tools
`pull_requests`	GitHub Pull Request related tools
`repos`	GitHub Repository related tools
`secret_protection`	Secret protection related tools, such as GitHub Secret Scanning
`users`	GitHub User related tools

Configuring Toolsets

You can specify which toolsets you want to enable when configuring the GitHub MCP server. This allows you to control which GitHub API capabilities are available to your AI tools.

Using Toolsets With Docker

When using Docker, you can pass the toolsets as environment variables:

bash

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  -e GITHUB_TOOLSETS="repos,issues,pull_requests,actions,code_security,experiments" \
  ghcr.io/github/github-mcp-server

The "all" Toolset

The special toolset all can be provided to enable all available toolsets regardless of any other configuration:

bash

# Using command line argument
./github-mcp-server --toolsets all

# Or using environment variable
GITHUB_TOOLSETS="all" ./github-mcp-server

When using Docker with the "all" toolset:

bash

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  -e GITHUB_TOOLSETS="all" \
  ghcr.io/github/github-mcp-server

Usage Examples

# Get repository information
Show me information about the tensorflow/tensorflow repository

# Search for code
Find examples of React hooks in facebook/react

# Create an issue
Create an issue in my repository about the login bug

Web Search Server

The Web Search MCP server provides access to web search results using the Brave Search API.

Capabilities

Search the web for information
Get real-time information not available in Kiro's training data

Setup Instructions

Prerequisites

Install Node.js and NPM if not already installed.
Get a Brave Search API key:
- Sign up at https://brave.com/search/api/
- Generate an API key

Configuration

json

{
  "mcpServers": {
     "web-search": {
      "command": "npx",
      "args": [
        "-y",
        "@brave/brave-search-mcp-server",
        "--transport",
        "stdio"
      ],
      "env": {
        "BRAVE_API_KEY": "your-api-key"
      }
    },
  }
}

Available Tools

Tool Name	Description
`brave_web_search`	Performs general web searches using Brave Search API
`brave_local_search`	Searches for local businesses and places using Brave's Local Search API
`brave_video_search`	Searches for videos using Brave's Video Search API
`brave_image_search`	Performs image searches using Brave Search API
`brave_news_search`	Searches for current news articles using Brave's News Search API
`brave_summarizer`	Retrieves AI-generated summaries of web search results using Brave's Summarizer API

Usage Examples

# Search for information
Find the latest information about TypeScript 5.0 features

# Search for news
What are the latest developments in quantum computing?

Remote MCP Servers

Warning

Security Note: Using remote MCP servers opens a connection between your local machine and the remote server. Only connect to secure remote servers that you trust and that are owned by a party whom you trust. A compromised remote could use the MCP connection to execute code on your local machine.

Kiro currently supports local stdio MCP servers, however you can add remote MCP servers by leveraging the mcp-remote npm package to make requests to the remote MCP endpoint.

Setup Instructions

Prerequisites

Install Node.js and NPM if not already installed.

Configuration

json

{
  "mcpServers": {
    "my-remote-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<remote-mcp-endpoint>",
        "--transport",
        "sse"
      ],
      "disabled": false
    }
  }
}

Custom MCP Servers

You can create your own MCP servers to extend Kiro's capabilities for your specific needs.

Creating a Custom Server

Choose a programming language (Python, Node.js, etc.)
Implement the MCP protocol using available libraries
Define your tools and their capabilities
Package and distribute your server

Resources for Custom Server Development

Additional MCP Servers

Database Servers

PostgreSQL MCP Server: Query and manage PostgreSQL databases
MongoDB MCP Server: Interact with MongoDB databases

Development Tools

Docker MCP Server: Manage Docker containers and images
Kubernetes MCP Server: Interact with Kubernetes clusters

Cloud Providers

Azure MCP Server: Interact with Azure services and resources
GCP MCP Server: Manage Google Cloud Platform resources

Finding More MCP Servers

To discover additional MCP servers:

Visit the MCP Registry
Check the GitHub MCP Organization
Search for mcp-server on npm or PyPI

For information on configuring MCP servers, see the MCP Configuration page.

Page updated: September 11, 2025

Configuration

Tools

This guide provides information about available Model Context Protocol (MCP) servers, their capabilities, and how to set them up with Kiro.

Warning

Only add MCP servers from trusted sources, and review all applicable server licensing information and documentation. Kiro is not responsible for any third-party MCP servers or other packages.

AWS Documentation Server

The AWS Documentation server provides access to AWS documentation, search capabilities, and content recommendations.

Capabilities

Search AWS documentation across all services
Read documentation pages in markdown format
Get content recommendations related to specific documentation pages

Setup Instructions

Prerequisites

Install uv from Astral:

bash

# On macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows PowerShell
irm https://astral.sh/uv/install.ps1 | iex

Install Python 3.10 or newer:
bash
```
uv python install 3.10
```

Configuration

For macOS/Linux:

json

{
  "mcpServers": {
    "aws-docs": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

For Windows:

json

{
  "mcpServers": {
    "aws-docs": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.aws-documentation-mcp-server@latest",
        "awslabs.aws-documentation-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

Available Tools

Tool Name	Description
`mcp_aws_docs_search_documentation`	Search AWS documentation for specific topics
`mcp_aws_docs_read_documentation`	Read AWS documentation pages in markdown format
`mcp_aws_docs_recommend`	Get content recommendations related to a documentation page

Usage Examples

# Search for information about S3 bucket policies
Search AWS documentation for S3 bucket policies

# Read specific documentation
Read the AWS Lambda function URLs documentation

# Get recommendations
Find related content to AWS ECS task definitions

GitHub MCP Server

The GitHub MCP server allows Kiro to interact with GitHub repositories, issues, and pull requests.

Capabilities

Access repository information including files, commits, and branches
Create and manage issues and pull requests
Search repositories for specific content

Setup Instructions

Warning

The previously recommended @modelcontextprotocol/server-github package has been archived. GitHub now recommends using their official Docker-based MCP server.

Prerequisites

Install Docker if not already installed:
- Docker Desktop for macOS and Windows
- Docker Engine for Linux
Create a GitHub Personal Access Token:
- Go to GitHub Settings > Developer settings > Personal access tokens (fine-grained)
- Generate a new token with permissions that fit the tools you need

Configuration

Follow these steps from the official GitHub documentation:

Create a .kiro/settings/mcp.json file in your workspace directory (or edit if it already exists)
Add this configuration:

json

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "-e", 
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

For more detailed installation instructions, refer to the official GitHub MCP Server documentation.

Common Tools

The GitHub MCP server provides a comprehensive set of tools for interacting with GitHub. Here are some of the most commonly used tools organized by category:

Repository Tools

Tool Name	Description
`search_repositories`	Search for GitHub repositories
`get_file_contents`	Get the contents of a file from a repository
`search_code`	Search for code in repositories
`list_branches`	List branches in a repository
`create_branch`	Create a new branch in a repository

Issue Tools

Tool Name	Description
`list_issues`	List issues in a repository
`get_issue`	Get details of a specific issue
`create_issue`	Create a new issue in a repository
`update_issue`	Update an existing issue
`add_issue_comment`	Add a comment to an issue

Pull Request Tools

Tool Name	Description
`list_pull_requests`	List pull requests in a repository
`get_pull_request`	Get details of a specific pull request
`create_pull_request`	Create a new pull request
`get_pull_request_files`	Get files changed in a pull request
`merge_pull_request`	Merge a pull request

Actions and Workflows

Tool Name	Description
`list_workflows`	List workflows in a repository
`list_workflow_runs`	List workflow runs for a specific workflow
`get_workflow_run`	Get details of a specific workflow run

Code Security

Tool Name	Description
`list_code_scanning_alerts`	List code scanning alerts in a repository
`get_code_scanning_alert`	Get details of a specific code scanning alert

Dependabot

Tool Name	Description
`list_dependabot_alerts`	List Dependabot alerts in a repository
`get_dependabot_alert`	Get details of a specific Dependabot alert

Discussions

Tool Name	Description
`list_discussions`	List discussions in a repository
`get_discussion`	Get details of a specific discussion
`get_discussion_comments`	Get comments from a discussion

Notifications

Tool Name	Description
`list_notifications`	List GitHub notifications
`get_notification_details`	Get detailed information for a specific notification
`mark_all_notifications_read`	Mark all notifications as read

Available Toolsets

The GitHub MCP server organizes its functionality into toolsets that can be enabled or disabled as needed. By default, all toolsets are enabled. Here's an overview of the available toolsets:

Toolset	Description
`context`	Strongly recommended: Tools that provide context about the current user and GitHub context you are operating in
`actions`	GitHub Actions workflows and CI/CD operations
`code_security`	Code security related tools, such as GitHub Code Scanning
`dependabot`	Dependabot tools
`discussions`	GitHub Discussions related tools
`experiments`	Experimental features that are not considered stable yet
`issues`	GitHub Issues related tools
`notifications`	GitHub Notifications related tools
`orgs`	GitHub Organization related tools
`pull_requests`	GitHub Pull Request related tools
`repos`	GitHub Repository related tools
`secret_protection`	Secret protection related tools, such as GitHub Secret Scanning
`users`	GitHub User related tools

Configuring Toolsets

You can specify which toolsets you want to enable when configuring the GitHub MCP server. This allows you to control which GitHub API capabilities are available to your AI tools.

Using Toolsets With Docker

When using Docker, you can pass the toolsets as environment variables:

bash

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  -e GITHUB_TOOLSETS="repos,issues,pull_requests,actions,code_security,experiments" \
  ghcr.io/github/github-mcp-server

The "all" Toolset

The special toolset all can be provided to enable all available toolsets regardless of any other configuration:

bash

# Using command line argument
./github-mcp-server --toolsets all

# Or using environment variable
GITHUB_TOOLSETS="all" ./github-mcp-server

When using Docker with the "all" toolset:

bash

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  -e GITHUB_TOOLSETS="all" \
  ghcr.io/github/github-mcp-server

Usage Examples

# Get repository information
Show me information about the tensorflow/tensorflow repository

# Search for code
Find examples of React hooks in facebook/react

# Create an issue
Create an issue in my repository about the login bug

Web Search Server

The Web Search MCP server provides access to web search results using the Brave Search API.

Capabilities

Search the web for information
Get real-time information not available in Kiro's training data

Setup Instructions

Prerequisites

Install Node.js and NPM if not already installed.
Get a Brave Search API key:
- Sign up at https://brave.com/search/api/
- Generate an API key

Configuration

json

{
  "mcpServers": {
     "web-search": {
      "command": "npx",
      "args": [
        "-y",
        "@brave/brave-search-mcp-server",
        "--transport",
        "stdio"
      ],
      "env": {
        "BRAVE_API_KEY": "your-api-key"
      }
    },
  }
}

Available Tools

Tool Name	Description
`brave_web_search`	Performs general web searches using Brave Search API
`brave_local_search`	Searches for local businesses and places using Brave's Local Search API
`brave_video_search`	Searches for videos using Brave's Video Search API
`brave_image_search`	Performs image searches using Brave Search API
`brave_news_search`	Searches for current news articles using Brave's News Search API
`brave_summarizer`	Retrieves AI-generated summaries of web search results using Brave's Summarizer API

Usage Examples

# Search for information
Find the latest information about TypeScript 5.0 features

# Search for news
What are the latest developments in quantum computing?

Remote MCP Servers

Warning

Kiro currently supports local stdio MCP servers, however you can add remote MCP servers by leveraging the mcp-remote npm package to make requests to the remote MCP endpoint.

Setup Instructions

Prerequisites

Install Node.js and NPM if not already installed.

Configuration

json

{
  "mcpServers": {
    "my-remote-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<remote-mcp-endpoint>",
        "--transport",
        "sse"
      ],
      "disabled": false
    }
  }
}

Custom MCP Servers

You can create your own MCP servers to extend Kiro's capabilities for your specific needs.

Creating a Custom Server

Choose a programming language (Python, Node.js, etc.)
Implement the MCP protocol using available libraries
Define your tools and their capabilities
Package and distribute your server

Resources for Custom Server Development

Additional MCP Servers

Database Servers

PostgreSQL MCP Server: Query and manage PostgreSQL databases
MongoDB MCP Server: Interact with MongoDB databases

Development Tools

Docker MCP Server: Manage Docker containers and images
Kubernetes MCP Server: Interact with Kubernetes clusters

Cloud Providers

Azure MCP Server: Interact with Azure services and resources
GCP MCP Server: Manage Google Cloud Platform resources

Finding More MCP Servers

To discover additional MCP servers:

Visit the MCP Registry
Check the GitHub MCP Organization
Search for mcp-server on npm or PyPI

For information on configuring MCP servers, see the MCP Configuration page.

Page updated: September 11, 2025

Configuration

Tools