# Zuplo MCP MCP

> Zuplo manages your API infrastructure—gateways, edge deployments, and consumer access—all via chat. Stop clicking through cloud consoles; let your agent provision identities, audit configs, or pull real-time traffic metrics for any project in seconds.

## Overview
- **Category:** ship-it
- **Price:** Free
- **Tags:** api-gateway, edge-computing, api-management, deployment-automation, traffic-control, developer-experience

## Description

Managing an API gateway used to mean navigating a nightmare of nested menus: create the project, then list environments, then verify the custom DNS domains, and finally, if everything looked okay, manually generate a key. Now, you just talk to your AI agent. You tell it which projects need monitoring or who needs access, and it handles the whole lifecycle. Need to check traffic latency? Just ask for metrics; no dashboard hopping required. When you connect this MCP through Vinkius, credentials pass through a zero-trust proxy—meaning your API keys are only used in transit, never stored on disk. This makes managing sensitive gateway authentication policies fast and secure. Your agent becomes the full platform engineer for Zuplo.

## Tools

### list_consumers
Retrieves a complete list of all active API key consumers in your account.

### create_consumer
Creates a new identity for an external user to access your APIs.

### create_deployment
Initiates and pushes a new version of your API configuration live across the edge network.

### delete_consumer
Permanently removes an external user's access key from the system.

### list_custom_domains
Lists every custom domain name assigned to your various API projects.

### list_environments
Shows which operational environments (like 'staging' or 'testing') are available for a project.

### list_files
Retrieves the configuration files that define how your gateway routes traffic and applies policies.

### list_deployments
Gets a history of all previous deployment actions taken on the gateway.

### get_metrics
Pulls real-time data on gateway traffic, latency, and overall performance.

### list_projects
Lists all API projects configured under your Zuplo account.

## Prompt Examples

**Prompt:** 
```
List all my Zuplo projects.
```

**Response:** 
```
I found 3 Zuplo projects: 1. 'Payment-Gateway-Main' (ID: proj-101), 2. 'User-Auth-Edge' (ID: proj-102), and 3. 'Legacy-API-Proxy' (ID: proj-103). Which one would you like to see metrics for?
```

**Prompt:** 
```
Check the latency metrics for 'proj-101'.
```

**Response:** 
```
Latency metrics for proj-101: Average p95 latency is 42ms. Total traffic in the last 24h: 1.2 million requests. Current error rate: 0.05%. Everything looks healthy across the edge network.
```

**Prompt:** 
```
Create a new consumer for 'Acme Partner' in project 'proj-101'.
```

**Response:** 
```
Success! I've provisioned a new consumer identity for 'Acme Partner' (ID: cons-999) in project proj-101. I can provide the associated API key details if you need them for delivery.
```

## Capabilities

### Audit Project Structure
List all existing projects and environments to map out your entire API integration setup.

### Control Consumer Access
Create new API key consumers or revoke old ones instantly, controlling who accesses which gateway authentication.

### Manage Deployments
Trigger configuration deployments to the global edge network or audit previous deployment history.

### Verify Domain Names
Retrieve and manage custom DNS domains configured for every API project.

### Analyze Traffic Performance
Monitor real-time gateway traffic, latency, and throughput metrics from the edge network.

### Review Gateway Logic
Browse and list the exact configuration files that define your API gateway's routing rules and policies.

## Use Cases

### Revoking Partner Access
A third-party vendor loses contract status. Instead of logging into the console and manually finding their credentials, the agent runs `list_consumers` to confirm their ID, then uses `delete_consumer` to instantly revoke all access.

### Auditing Gateway Changes
A security review requires knowing who changed what. The engineer first calls `list_projects`, then runs `list_deployments` to see the full history of changes, ensuring no unauthorized deployments occurred.

### Verifying Staging Readiness
Before a major release, the team needs proof that all environments are ready. The agent uses `list_environments` and checks the status across multiple projects to ensure nothing is stuck in an unknown state.

### Mapping API Domains
A new region requires custom endpoints. The platform team runs `list_custom_domains` to see what's already configured, and then uses `list_projects` to scope the necessary additions.

## Benefits

- Stop manually checking deployments. You can trigger new configurations using `create_deployment` with a simple command, immediately updating the global edge network.
- Need to control access? Use `list_consumers` first, then run `create_consumer` or `delete_consumer` without ever touching a permissions panel.
- Performance monitoring is instant. Just ask for metrics and get real-time data on latency and throughput using `get_metrics`, eliminating dashboard logging in your mind.
- Debugging gateway logic gets easy. Instead of searching through logs, you can use `list_files` to see the exact configuration files defining routing policies.
- Get a full picture of your setup by running `list_projects` and then following up with `list_environments`, giving you instant visibility into every corner of your API surface.

## How It Works

The bottom line is that it lets you manage complex API infrastructure without ever logging into a web console.

1. First, connect your Zuplo account credentials to Vinkius. You enter your main API Key once.
2. Next, use your AI client to ask for what you need—for example, 'list all projects' or 'check the metrics for project X.'
3. The agent executes the specific action via the MCP and returns the structured data directly into your chat interface.

## Frequently Asked Questions

**How do I check gateway performance using `get_metrics`?**
Simply ask your agent to get edge metrics for the relevant project. The system returns real-time data on latency, traffic volume, and error rates without you needing to navigate a dedicated analytics dashboard.

**What is the difference between `list_deployments` and `list_environments`?**
`list_environments` shows the available lifecycle stages (like 'working' or 'production') for a project. In contrast, `list_deployments` tracks the historical record of when configuration changes were actually pushed out to the gateway.

**Can I create and delete users using `create_consumer` and `delete_consumer`?**
Yes, those tools handle the full consumer lifecycle. You tell your agent who needs access, it runs `create_consumer`, and when they leave, you use `delete_consumer` to revoke their key immediately.

**How does Zuplo manage custom domains? Do I need `list_custom_domains`?**
You run `list_custom_domains` directly through the agent. It retrieves and lists all configured DNS names for your API projects, saving you from manually checking domain records in multiple zones.

**I need to check the routing rules; how do I use `list_files`?**
It lists the specific configuration files that define your gateway’s routing and policy logic. This lets you audit what traffic patterns are currently allowed or restricted by your API project.

**When starting with a new set of APIs, how does `list_projects` help me scope my work?**
It provides a complete inventory of all Zuplo projects connected to your account. This ensures you can quickly identify the exact project ID before attempting any deployments or consumer management.

**If I need to update an API version, is `create_deployment` the right tool?**
Yes, triggering a deployment via this tool pushes new configurations to your edge network. You use it to initiate changes, which is necessary for rolling out updates or fixing bad versions.

**How can I audit all active API key consumers without listing every project? Use `list_consumers`.**
Running this tool gives you a direct list of every provisioned consumer identity. This is the fastest way to check who has access and verify credentials for compliance checks.

**Can I check my API gateway metrics through the agent?**
Yes. The `get_metrics` tool allows your AI agent to retrieve real-time traffic and latency data for any specific project ID, helping you monitor gateway performance directly through chat.

**How do I create a new consumer identity for API key authentication?**
You can use the `create_consumer` tool. Provide the project ID and a JSON payload with the consumer's details, and Zuplo will provision the new identity for your API gateway instantly.

**Is it possible to see my project's configuration files via conversation?**
Absolutely. Use the `list_project_files` tool to retrieve the declarative configuration files for your API project, allowing you to audit routing and policy definitions through your agent.