How do I install the Azure Relay skill?

Run npx skillmds@latest add atc-net/azure-relay in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Azure Relay safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Azure Relay?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Azure Relay free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Azure Relay?

atc-net (@atc-net) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Azure Relay by atc-net — Agent Skill

Name: Azure Relay
Rating: 4.5 (4 reviews)
Author: atc-net

Azure Relay

Expert knowledge for Azure Relay development including troubleshooting, security, configuration, and integrations & coding patterns. Use when configuring Hybrid Connections, WCF relays, Entra ID/SAS auth, Private Link, or .NET/Node.js Relay clients, and other Azure Relay related development tasks. Not for Azure Service Bus (use azure-service-bus), Azure Event Hubs (use azure-event-hubs), Azure Web PubSub (use azure-web-pubsub), Azure Application Gateway (use azure-application-gateway).

atc-net Updated Aug 19, 2026 3 repo stars

File contents

Azure Relay Skill

This skill provides expert guidance for Azure Relay. Covers troubleshooting, security, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

This skill requires network access to fetch documentation content:

Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch. Returns Markdown.
Fallback: Use WebFetch. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L28-L32	Diagnosing and fixing common Azure Relay exceptions, including connection, authentication, quota, and configuration errors, with guidance on causes and resolutions.
Security	L33-L42	Authentication and network security for Azure Relay: Entra ID and SAS auth, managed identities, IP firewall, virtual network rules, and Private Link Service configuration.
Configuration	L43-L47	Network and firewall requirements for Azure Relay, including which ports/protocols to open for Hybrid Connections and WCF relays and how to configure them.
Integrations & Coding Patterns	L48-L53	Using Azure Relay Hybrid Connections from .NET and Node.js (WebSockets), plus low-level protocol details for implementing custom clients and integrations

Troubleshooting

Topic	URL
Resolve common Azure Relay exceptions	https://learn.microsoft.com/en-us/azure/azure-relay/relay-exceptions

Security

Topic	URL
Authenticate applications to Azure Relay with Entra ID	https://learn.microsoft.com/en-us/azure/azure-relay/authenticate-application
Use managed identities to access Azure Relay	https://learn.microsoft.com/en-us/azure/azure-relay/authenticate-managed-identity
Configure IP firewall rules for Azure Relay	https://learn.microsoft.com/en-us/azure/azure-relay/ip-firewall-virtual-networks
Configure network security for Azure Relay	https://learn.microsoft.com/en-us/azure/azure-relay/network-security
Secure Azure Relay with Private Link Service	https://learn.microsoft.com/en-us/azure/azure-relay/private-link-service
Configure SAS and Entra ID auth for Azure Relay	https://learn.microsoft.com/en-us/azure/azure-relay/relay-authentication-and-authorization

Configuration

Topic	URL
Configure required port settings for Azure Relay	https://learn.microsoft.com/en-us/azure/azure-relay/relay-port-settings

Integrations & Coding Patterns

Topic	URL
Use Azure Relay Hybrid Connections .NET APIs	https://learn.microsoft.com/en-us/azure/azure-relay/relay-hybrid-connections-dotnet-api-overview
Use Azure Relay Node.js WebSocket APIs	https://learn.microsoft.com/en-us/azure/azure-relay/relay-hybrid-connections-node-ws-api-overview
Implement Azure Relay Hybrid Connections protocol	https://learn.microsoft.com/en-us/azure/azure-relay/relay-hybrid-connections-protocol

---name: azure-relaydescription: Expert knowledge for Azure Relay development including troubleshooting, security, configuration, and integrations & coding patterns. Use when configuring Hybrid Connections, WCF relays, Entra ID/SAS auth, Private Link, or .NET/Node.js Relay clients, and other Azure Relay related development tasks. Not for Azure Service Bus (use azure-service-bus), Azure Event Hubs (use azure-event-hubs), Azure Web PubSub (use azure-web-pubsub), Azure Application Gateway (use azure-application-gateway).---# Azure Relay SkillThis skill provides expert guidance for Azure Relay. Covers troubleshooting, security, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.## How to Use This Skill> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference fileThis skill requires **network access** to fetch documentation content:- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch`. Returns Markdown.- **Fallback**: Use `WebFetch`. Returns Markdown.## Category Index| Category | Lines | Description ||----------|-------|-------------|| Troubleshooting | L28-L32 | Diagnosing and fixing common Azure Relay exceptions, including connection, authentication, quota, and configuration errors, with guidance on causes and resolutions. || Security | L33-L42 | Authentication and network security for Azure Relay: Entra ID and SAS auth, managed identities, IP firewall, virtual network rules, and Private Link Service configuration. || Configuration | L43-L47 | Network and firewall requirements for Azure Relay, including which ports/protocols to open for Hybrid Connections and WCF relays and how to configure them. || Integrations & Coding Patterns | L48-L53 | Using Azure Relay Hybrid Connections from .NET and Node.js (WebSockets), plus low-level protocol details for implementing custom clients and integrations |### Troubleshooting| Topic | URL ||-------|-----|| Resolve common Azure Relay exceptions | https://learn.microsoft.com/en-us/azure/azure-relay/relay-exceptions |### Security| Topic | URL ||-------|-----|| Authenticate applications to Azure Relay with Entra ID | https://learn.microsoft.com/en-us/azure/azure-relay/authenticate-application || Use managed identities to access Azure Relay | https://learn.microsoft.com/en-us/azure/azure-relay/authenticate-managed-identity || Configure IP firewall rules for Azure Relay | https://learn.microsoft.com/en-us/azure/azure-relay/ip-firewall-virtual-networks || Configure network security for Azure Relay | https://learn.microsoft.com/en-us/azure/azure-relay/network-security || Secure Azure Relay with Private Link Service | https://learn.microsoft.com/en-us/azure/azure-relay/private-link-service || Configure SAS and Entra ID auth for Azure Relay | https://learn.microsoft.com/en-us/azure/azure-relay/relay-authentication-and-authorization |### Configuration| Topic | URL ||-------|-----|| Configure required port settings for Azure Relay | https://learn.microsoft.com/en-us/azure/azure-relay/relay-port-settings |### Integrations & Coding Patterns| Topic | URL ||-------|-----|| Use Azure Relay Hybrid Connections .NET APIs | https://learn.microsoft.com/en-us/azure/azure-relay/relay-hybrid-connections-dotnet-api-overview || Use Azure Relay Node.js WebSocket APIs | https://learn.microsoft.com/en-us/azure/azure-relay/relay-hybrid-connections-node-ws-api-overview || Implement Azure Relay Hybrid Connections protocol | https://learn.microsoft.com/en-us/azure/azure-relay/relay-hybrid-connections-protocol |

Frequently asked questions