portkey-admin-mcp

List all users in your Portkey organization, including their roles and account details

Invite a new user to your Portkey organization with specific workspace access and API key permissions

Retrieve detailed analytics data about user activity within a specified time range, including request counts and costs

Retrieve detailed information about a specific user by their ID

Update a user's profile information including name and organization role

Remove a user from your Portkey organization. This action cannot be undone.

List all pending and sent user invitations in your Portkey organization

Retrieve details about a specific user invitation

Cancel and delete a pending user invitation

Resend an invitation email to a pending user

Retrieve all workspaces in your Portkey organization, including their configurations and metadata

Retrieve detailed information about a specific workspace, including its configuration, metadata, and user access details

Create a new workspace in your Portkey organization

Update an existing workspace's settings and metadata

Delete a workspace from your organization. This action cannot be undone.

Add a user to a workspace with a specific role

List all members of a workspace with their roles

Get details about a specific member of a workspace

Update a member's role in a workspace

Remove a user from a workspace

Retrieve all configurations in your Portkey organization, including their status and workspace associations

Retrieve detailed information about a specific configuration, including cache settings, retry policies, and routing strategy

Create a new configuration with cache, retry, and routing settings

Update an existing configuration's cache, retry, or routing settings

Delete a configuration by slug. This action cannot be undone.

List all versions of a configuration to view its change history

Retrieve all virtual keys in your Portkey organization, including their usage limits, rate limits, and status

Create a new virtual key for a provider (e.g., openai, anthropic). Virtual keys securely store provider API keys.

Retrieve detailed information about a specific virtual key by its slug

Update an existing virtual key's name, API key, note, or limits

Delete a virtual key by slug. This action cannot be undone.

Create a new Portkey API key for authentication. Organisation-level keys provide full access, workspace keys are scoped.

List all API keys in your Portkey organization with optional pagination and workspace filtering

Retrieve detailed information about a specific API key by its UUID

Update an existing API key's name, description, scopes, or limits

Delete an API key by UUID. This action cannot be undone.

List all prompt collections in your Portkey organization. Collections group prompts by app (e.g., hourlink, apizone, research-pilot).

Create a new prompt collection for organizing prompts by app. Use one collection per app (hourlink, apizone, research-pilot).

Retrieve detailed information about a specific collection

Update a collection's name or description

Delete a collection by ID. This action cannot be undone. Prompts in this collection will become orphaned.

Create a new prompt template in Portkey. Prompts are versioned message templates with variable substitution support.

List all prompts in your Portkey organization with optional filtering by collection, workspace, or search query

Retrieve detailed information about a specific prompt including its template, parameters, and version history

Update an existing prompt template. Creates a new version with the changes.

Delete a prompt by its ID. This action cannot be undone and will remove the prompt and all its versions.

Publish a specific version of a prompt, making it the default version that will be used when the prompt is called. This is useful for promoting a tested version to production.

List all versions of a specific prompt with their details, including version number, description, template content, and creation date.

Render a prompt template by substituting variables, returning the final messages without executing

Execute a prompt template with variables and get the model completion response. REQUIRES billing metadata (client_id, app, env).

Create or update a prompt based on whether it exists. Useful for CI/CD and prompt-as-code workflows. Finds existing prompts by name within the collection.

Promote a prompt from one environment to another (e.g., staging → prod). Copies the current version to the target environment.

Validate billing metadata before running a completion. Checks for required fields (client_id, app, env) and valid values.

Retrieve detailed cost analytics data over time, including total costs and averages per request

Retrieve request analytics as time-series data, showing total, successful, and failed requests over time

Retrieve token usage analytics as time-series data, showing total, prompt, and completion tokens over time

Retrieve latency analytics as time-series data, showing average, p50, p90, and p99 latency percentiles over time

Retrieve error count analytics as time-series data, showing total error counts over time

Retrieve error rate analytics as time-series data, showing the percentage of failed requests over time

Retrieve cache hit latency analytics as time-series data, showing total and average latency for cache hits over time

Retrieve cache hit rate analytics as time-series data, showing hit rate percentage, total hits, and misses over time

Retrieve user activity analytics over time, showing active and new user counts

List all guardrails in your Portkey organization with optional filtering by workspace or organization

Retrieve detailed information about a specific guardrail, including its checks and actions configuration

Create a new guardrail with specified checks and actions for content moderation and security

Update an existing guardrail's name, checks, or actions configuration

Delete a guardrail by its ID or slug. This action cannot be undone.

Retrieve all usage limits in your Portkey organization. Usage limits control how much of a resource (tokens, requests, cost) can be consumed within a time period.

Retrieve detailed information about a specific usage limit by its ID

Create a new usage limit to control resource consumption within a time period

Update an existing usage limit's configuration

Delete a usage limit by ID. This action cannot be undone.

Retrieve all rate limits in your Portkey organization. Rate limits control how many requests can be made within a time window.

Retrieve detailed information about a specific rate limit by its ID

Create a new rate limit to control request frequency within a time window

Update an existing rate limit's configuration

Delete a rate limit by ID. This action cannot be undone.

Retrieve audit logs for your Portkey organization. Audit logs track all administrative actions including user management, configuration changes, and access events. Supports filtering by time range, actor, action type, and resource.

Create a new prompt label to categorize and organize prompts. Labels can be color-coded and scoped to workspaces or organizations.

List all prompt labels in your Portkey organization with optional filtering by workspace, organisation, or search query

Retrieve detailed information about a specific prompt label

Update an existing prompt label's name, description, or color

Delete a prompt label by ID. This action cannot be undone.

Create a new prompt partial (reusable text snippet) that can be included in prompts using mustache syntax like {{> partial_name}}

List all prompt partials in your Portkey organization with optional filtering by collection

Retrieve detailed information about a specific prompt partial including its content and version info

Update an existing prompt partial. Creates a new version with the changes.

Delete a prompt partial by ID. This action cannot be undone.

List all versions of a prompt partial to view its change history

Publish a specific version of a prompt partial, making it the default version

Create feedback for a specific trace/request. Use this to capture user feedback (thumbs up/down, ratings) on AI generations. Feedback is linked via trace_id and can include custom metadata for analysis.

Update existing feedback by ID. Allows modifying the feedback value, weight, or metadata after initial creation.

List all traces in your Portkey workspace with optional filtering. Returns trace metadata including requests, responses, costs, and token usage.

Retrieve detailed information about a specific trace by ID. Returns full request/response data, all spans, metadata, cost, token usage, and any associated feedback.

Insert a log entry (or multiple entries) into Portkey for tracking AI requests and responses

Create a new log export job to export logs matching specified filters

List all log export jobs for a workspace

Get details of a specific log export by its ID

Start a log export job that was previously created

Cancel a running log export job