Can my agent retrieve a privileged password for an emergency maintenance task?

Yes. Use the 'retrieve_password' tool. You must provide the account ID and a justification reason. The agent pulls the secret from the Vault, and the action is fully audited in CyberArk's system logs for compliance.

How do I terminate a suspicious active session via the agent?

Provide the session ID to the 'terminate_session' tool. The agent will dispatch an instant interrupt signal to the CyberArk platform, killing the live SSH or RDP session immediately to prevent unauthorized actions.

Is it possible to add new service accounts to a Safe through chat?

Absolutely. Use the 'add_account' tool. You'll need to specify the account name, address, username, platform ID, and the destination Safe. Your agent will onboard the credential and link it to the CPM for automated rotation.

CyberArk Privilege Cloud MCP Server for OpenAI Agents SDK 10 tools — connect in under 2 minutes

Name: CyberArk Privilege Cloud
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 10 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect CyberArk Privilege Cloud through the Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails — no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token — get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="CyberArk Privilege Cloud Assistant",
            instructions=(
                "You help users interact with CyberArk Privilege Cloud. "
                "You have access to 10 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from CyberArk Privilege Cloud"
        )
        print(result.final_output)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About CyberArk Privilege Cloud MCP Server

Connect your CyberArk Privilege Cloud account to any AI agent and take full control of your identity security and privileged access management through natural conversation.

The OpenAI Agents SDK auto-discovers all 10 tools from CyberArk Privilege Cloud through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns — chain multiple agents where one queries CyberArk Privilege Cloud, another analyzes results, and a third generates reports, all orchestrated through the Vinkius.

What you can do

Safe Orchestration — List secure Safes and retrieve intricate settings including retention periods and assigned Central Policy Managers (CPM)
Privileged Account Management — Enumerate vaulted credentials (Root, Administrator, Service Accounts) and audit rotational statuses and address mappings
Password Retrieval (Check-out) — Pull actual secrets from the Vault with mandatory audited justifications, allowing the agent to securely retrieve credentials for incident response
Identity Oversight — List internal and LDAP-mapped directory users and groups to verify PAM logical access architectures and RBAC rules
Session Control — Forcibly terminate active PSM/PSMP privileged sessions instantly as an active incident response mechanism
Vault Onboarding — Provision new privileged accounts into secure Safes by mapping them to specific platform IDs for automated rotation lifecycle management

The CyberArk Privilege Cloud MCP Server exposes 10 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect CyberArk Privilege Cloud to OpenAI Agents SDK via MCP

Follow these steps to integrate the CyberArk Privilege Cloud MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 10 tools from CyberArk Privilege Cloud

Why Use OpenAI Agents SDK with the CyberArk Privilege Cloud MCP Server

OpenAI Agents SDK provides unique advantages when paired with CyberArk Privilege Cloud through the Model Context Protocol.

Native MCP integration via `MCPServerSse` — pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

CyberArk Privilege Cloud + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the CyberArk Privilege Cloud MCP Server delivers measurable value.

Automated workflows: build agents that query CyberArk Privilege Cloud, process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents — one queries CyberArk Privilege Cloud, another analyzes results, a third generates reports

Data enrichment pipelines: stream data through CyberArk Privilege Cloud tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query CyberArk Privilege Cloud to resolve tickets, look up records, and update statuses without human intervention

CyberArk Privilege Cloud MCP Tools for OpenAI Agents SDK (10)

These 10 tools become available when you connect CyberArk Privilege Cloud to OpenAI Agents SDK via MCP:

add_account

Requires precise mapping to an underlying Platform ID (e.g., WinDesktopLocal, UnixSSH) which dictates how CyberArk rotates and verifies the credential moving forward. Provision a new privileged account into a Vault Safe

delete_account

Requires high authorization. Used during system decommissioning so the CPM stops attempting failed password rotations. Delete a privileged account from the CyberArk Vault

get_account

Necessary before rotating or interacting with an account. Get detailed properties for a specific vaulted account

get_safe

Get details and metadata for a specific PAM Safe

list_accounts

These represent highly sensitive credentials (Root, Administrator, Service Accounts). Includes the bounding platform, Safe allocation, address, and rotational status. Use the search string to narrow targets. Search and list privileged accounts vaulted in CyberArk

list_groups

Permissions to Safes are canonically granted to Groups rather than individual users to enforce RBAC best practices. Used to verify PAM logical access architectures. List CyberArk Vault User Groups

list_safes

Safes are the fundamental logical containers separating credentials physically and logically. Required to locate where specific critical tier-0 credentials or local admin passwords reside. List all secure Safes in CyberArk Privileged Access Manager

list_users

Identifies active vault administrators, auditors, and human end-users consuming PSM (Privileged Session Manager) sessions. List all CyberArk users (local and synchronized)

retrieve_password

Highly audited endpoint triggering SIEM alerts. A justification reason is mandatory. After retrieval, exclusive access platforms may lock the credential until check-in or auto-rotation. Retrieve the clear-text password for an account (check-out)

terminate_session

Used as an active incident response mechanism if a SOC analyst or anomalous behavior engine detects unauthorized actions mid-session. Forcibly terminate an active Privileged Session (PSM/PSMP)

Example Prompts for CyberArk Privilege Cloud in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with CyberArk Privilege Cloud immediately.

"List all privileged accounts for address '10.0.0.1'"

"Retrieve password for account 123. Reason: 'Emergency DB maintenance'"

"Terminate active session 'sess_abc'"

Troubleshooting CyberArk Privilege Cloud MCP Server with OpenAI Agents SDK

Common issues when connecting CyberArk Privilege Cloud to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

CyberArk Privilege Cloud + OpenAI Agents SDK FAQ

Common questions about integrating CyberArk Privilege Cloud MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.