Skip to main content

DX MCP Server

The DX MCP Server is a Model Context Protocol (MCP) server that empowers AI assistants with deep knowledge of PagoPA's DX ecosystem. It bridges the gap between AI-powered development tools and PagoPA's technical documentation, best practices, and code repositories.

What is the Model Context Protocol?​

The Model Context Protocol (MCP) is an open standard that enables AI assistants to interact with external tools and data sources in a structured way. MCP-compliant clients (like GitHub Copilot, Claude Desktop, or VS Code) can connect to MCP servers to access specialized knowledge and capabilities.

How It Works​

The DX MCP Server provides AI assistants with access to:

  1. PagoPA DX Documentation: Query the complete DX technical documentation using natural language
  2. GitHub Code Search: Search for real-world code examples across PagoPA's GitHub repositories
  3. Smart Prompts: Pre-configured prompts designed for common tasks like Terraform configuration, code review, and infrastructure analysis

Getting Started​

Prerequisites​

You'll need:

  • An MCP-compliant AI assistant (GitHub Copilot, VS Code with Copilot, etc.)
  • A GitHub Personal Access Token (PAT) with appropriate permissions

Configuration​

VS Code / GitHub Copilot​

Add the following to your MCP configuration file. See VS Code MCP docs for details.

{
  "servers": {
    "dx-docs": {
      "url": "https://api.dx.pagopa.it/mcp",
      "type": "http",
      "headers": {
        "x-gh-pat": "${input:github_mcp_pat}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "github_mcp_pat",
      "description": "GitHub Personal Access Token",
      "password": true
    }
  ]
}

GitHub Copilot Coding Agent​

Configure in your repository settings under "Copilot" >> "Coding agent". See GitHub Copilot MCP docs for more info.

{
  "mcpServers": {
    "pagopa-dx": {
      "url": "https://api.dx.pagopa.it/mcp",
      "type": "http",
      "tools": ["*"],
      "headers": {
        "x-gh-pat": "$COPILOT_MCP_BOT_GH_PAT"
      }
    }
  }
}

GitHub Copilot CLI​

To use the MCP server with GitHub Copilot CLI, run the cli with copilot and prompt /mcp add to start the configuration of the MCP server

Follow the guided wizard to start using the DX MCP server:

  1. Server Name: pagopa-dx
  2. Server Type: 2 (HTTP)
  3. URL: https://api.dx.pagopa.it/mcp
  4. HTTP Headers: {"x-gh-pat": "<your-gh-PAT>"}
  5. Tools: * (leave as is)

Use Tab to navigate between fields and Ctrl+S to save.

Available Capabilities​

Tools​

  • QueryPagoPADXDocumentation: Query the DX documentation using natural language
  • SearchGitHubCode: Find code examples across PagoPA repositories

Prompts​

The server provides a collection of intelligent prompts for common development tasks. These prompts give guidelines to the agent on PagoPA's conventions and best practices. Explore them in the DX prompts catalog.

Learn More​