# ngrok MCP for AI Agents AI Agent Connect

> ngrok lets you manage your entire tunneling infrastructure through a chat interface. You can list endpoints, check reserved domains, audit IP policies, and manage API keys without switching tabs. It turns your ngrok dashboard into a conversational tool for your AI agent.

## Overview
- **Category:** loved-by-devs
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_W7kWDZ5TzVjqcXyqlwc5ZMjOxjJKvoo33HXcSC0o/ai-agent-connect
- **Tags:** tunneling, ingress, api-gateway, network-security, remote-access

## Description

Instead of clicking through the ngrok dashboard to find that one specific tunnel URL or checking if a domain is reserved, you just ask your agent. This Connector connects your ngrok account directly to your workflow. When you're trying to figure out which IP policies are blocking a connection or need to see every active endpoint in your fleet, you just type it out. It takes the manual labor out of infrastructure management. You can see your vaults, check your keys, and audit your security rules in seconds. It's a big part of why the Vinkius catalog is so useful for devs; it gives you a way to manage complex networking tools without the usual overhead. You get a clear view of your tunnels and security setup exactly when you need it, right where you're already working.

## Tools

### list_https_edges
View your HTTPS edge configurations to see how your traffic is being routed.

### list_ip_policies
Check the IP policies applied to your dashboard or agents to verify access controls.

### list_ip_restrictions
See every IP restriction currently in place to troubleshoot connectivity issues.

### list_reserved_domains
Pull a list of all custom domains you've reserved in your ngrok cloud account.

### list_vaults
View your secure vaults to see where sensitive values are stored for your applications.

### list_api_keys
See all your active ngrok API keys in one list to keep track of your credentials.

### list_endpoints
Get a full list of all active public URLs for your tunnels, including ephemeral and cloud ones.

## Prompt Examples

**Prompt:** 
```
What are my active ngrok tunnels?
```

**Response:** 
```
I've pulled your current tunnel status:

| Tunnel URL | ID | Status |
| :--- | :--- | :--- |
| `https://myapp.ngrok-free.app` | `ep_123` | **Active** |
| `https://api.example.com` | `ep_456` | **Active** |
```

**Prompt:** 
```
Show me the reserved domains in my account.
```

**Response:** 
```
I found 3 reserved domains in your ngrok cloud:

*   **dev.local** (Active)
*   **staging.myapp.com** (Active)
*   **prod.myapp.com** (Active)
```

**Prompt:** 
```
What IP policies are currently configured?
```

**Response:** 
```
I found 1 active IP policy:

*   **Office-Only-Access** (ID: `ipp_789`)
    *   *Description:* Restricts access to the corporate CIDR range.
```

## Capabilities

### List active tunnels
Get a full list of all active public URLs for your tunnels, including ephemeral and cloud ones.

### Check reserved domains
Pull a list of all custom domains you've reserved in your ngrok cloud account.

### Audit IP restrictions
See every IP restriction currently in place to troubleshoot connectivity issues.

### Inspect HTTPS edge configs
View your HTTPS edge configurations to see how your traffic is being routed.

### Manage API keys
See all your active ngrok API keys in one list to keep track of your credentials.

### View secure vaults
View your secure vaults to see where sensitive values are stored for your applications.

### Review IP policies
Check the IP policies applied to your dashboard or agents to verify access controls.

## Use Cases

### Troubleshooting a blocked connection
A developer asks the agent to check IP restrictions. The agent uses list_ip_restrictions and identifies a corporate CIDR block that is too narrow.

### Onboarding a new project
A teammate needs a custom URL. The agent uses list_reserved_domains to see what is available and tells the dev which ones are free.

### Security audit
A security lead asks for a list of all API keys. The agent uses list_api_keys to provide a summary of active credentials for the audit.

### Verifying edge configurations
A backend dev wants to know how traffic is hitting their production site. The agent uses list_https_edges to show the current routing rules.

## Benefits

- Stop tab switching by using list_endpoints to see all your active tunnels instantly.
- Audit your security posture faster by using list_ip_policies to see who can access your infrastructure.
- Keep your credentials organized by using list_api_keys to manage your authentication keys in one place.
- Verify your custom branding by using list_reserved_domains to see every domain tied to your account.
- Secure your secrets more easily by using list_vaults to check your sensitive data storage.
- Debug routing issues faster by using list_https_edges to inspect your edge configurations.

## How It Works

The bottom line is you get instant, conversational access to your ngrok infrastructure without leaving your chat window.

1. Subscribe to the ngrok MCP on Vinkius.
2. Paste your ngrok API Key into your client's configuration.
3. Ask your agent to list endpoints or check security policies.

## Frequently Asked Questions

**Can I use the ngrok MCP to see my tunnels?**
Yes, you can ask your agent to list all active tunnels. It will provide a clear list of your public URLs and IDs so you don't have to check the dashboard.

**Does the ngrok MCP help with security?**
Yes, it allows you to audit your IP policies and restrictions. You can quickly see who has access to your infrastructure and verify your security rules.

**How do I see my reserved domains with ngrok?**
Just ask your agent to list your reserved domains. It will pull the list of custom domains tied to your account directly into your chat.

**Can I manage my API keys using this?**
You can use it to list your active ngrok API keys. This helps you keep track of your credentials and manage authentication across your projects.

**Is this good for DevOps teams?**
It is excellent for DevOps. It gives you a way to audit infrastructure, check edge configs, and monitor security policies across an entire organization in seconds.

**Can I check my vault secrets?**
Yes, the Connector lets you view your secure vaults. This is a great way to check where your sensitive values are stored without manually hunting through settings.

**Can I see all my active public URLs currently served by ngrok?**
Yes! Use the `list_endpoints` tool to retrieve all public URLs, whether they are ephemeral, edge-based, or cloud endpoints.

**How do I check which custom domains I have reserved?**
Simply ask the agent to run the `list_reserved_domains` action. It will return a list of all custom domains configured in your ngrok account.

**Is it possible to audit my IP security policies?**
Yes. You can use `list_ip_policies` and `list_ip_restrictions` to review the access control rules applied to your infrastructure.