Percy MCP Server for OpenAI Agents SDK 10 tools — connect in under 2 minutes
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Percy through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
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="Percy Assistant",
instructions=(
"You help users interact with Percy. "
"You have access to 10 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from Percy"
)
print(result.final_output)
asyncio.run(main())
* 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 Percy MCP Server
Inject precision quality assurance workflows directly bounding LLM models via the Percy Visual Testing API (by BrowserStack). Programmatically verify pixel regressions executing queries evaluating visual boundaries natively across target projects. Inspect deep status arrays parsing CI build limits dynamically, extract metrics evaluating granular snapshot checkpoints asynchronously, and force immediate test baseline approvals seamlessly directly from explicit prompt commands naturally.
The OpenAI Agents SDK auto-discovers all 10 tools from Percy through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Percy, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
What you can do
- Project Navigation — Read bounded parameters tracking Percy deployments isolating configurations determining explicitly specific active QA targets natively
- Automated Build Oversight — Track specific arrays extracting dynamic checks returning pipeline checkpoints (approved/failed/unreviewed limits) explicitly seamlessly
- Visual Snapshot Operations — Log natively extracting bounds verifying comparison properties logging rendering differences mapping exact explicit width constraints
- Baseline Affirmations — Mutate bounding loops forcing active execution of JSON logic structurally bypassing native clicks allowing test approvals implicitly (
approve_buildorapprove_snapshot)
The Percy 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 Percy to OpenAI Agents SDK via MCP
Follow these steps to integrate the Percy 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 Percy
Why Use OpenAI Agents SDK with the Percy MCP Server
OpenAI Agents SDK provides unique advantages when paired with Percy 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
Percy + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the Percy MCP Server delivers measurable value.
Automated workflows: build agents that query Percy, process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries Percy, another analyzes results, a third generates reports
Data enrichment pipelines: stream data through Percy tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query Percy to resolve tickets, look up records, and update statuses without human intervention
Percy MCP Tools for OpenAI Agents SDK (10)
These 10 tools become available when you connect Percy to OpenAI Agents SDK via MCP:
approve_build
/approve` moving the test suite to green. Approve all unreviewed snapshots in a Percy build. Marks the entire build as visually approved for deployment
approve_snapshot
Approve a single Percy snapshot. Marks it as visually correct, updating the baseline for future comparisons
get_build_details
Get full details of a Percy build including state, total/unreviewed snapshot counts, approved/rejected snapshots, branch, commit SHA, and finalized timestamp
get_project_details
Get full details of a Percy project including name, slug, default branch, auto-approve enabled, browser targets, and build count
get_snapshot_details
Get full details of a Percy snapshot including name, review state, widths, fingerprint, and comparison count
list_browsers
List all supported browser families on Percy. Returns browser names, versions, and OS combinations for cross-browser visual testing
list_builds
List builds for a Percy project. Each build contains snapshots from a test run. Returns build IDs, states (processing/finished/failed), branch names, commit SHAs, and snapshot counts
list_comparisons
List visual comparisons for a Percy snapshot. Each comparison shows the diff between baseline and head at a specific width/browser. Returns diff images, diff percentages, and browser info
list_projects
List all projects on Percy (BrowserStack). Percy is the leading visual regression testing platform that captures snapshots and detects pixel-level UI differences across builds. Uses JSON:API format. Returns project names, slugs, and browser configs
list_snapshots
List snapshots in a Percy build. Each snapshot is a captured page/component at specific widths and browsers. Returns snapshot names, review states (unreviewed/approved/rejected), and diff percentages
Example Prompts for Percy in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Percy immediately.
"Log explicitly the builds targeting structural limits seamlessly isolating project 'org-slug/my-app' dynamically checking bounding states natively."
"Reverse check explicit structures extracting limits comparing properties cleanly bounding snapshot ID 'snap_778' natively efficiently."
"Force explicit validation mutating boundaries executing structurally an approval across build ID '8910' automatically natively flawlessly securely."
Troubleshooting Percy MCP Server with OpenAI Agents SDK
Common issues when connecting Percy to OpenAI Agents SDK through the Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
Percy + OpenAI Agents SDK FAQ
Common questions about integrating Percy MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Connect Percy with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Percy to OpenAI Agents SDK
Get your token, paste the configuration, and start using 10 tools in under 2 minutes. No API key management needed.
