Stoplight Connector for AI agents.
7 live capabilities
Manage your OpenAPI schemas and API documentation through a conversational interface.
Waiting for input…
Why people use Stoplight
Stoplight for API Schema Management and Documentation
With this Connector, you can just ask your agent to do the digging for you. It can pull the exact schema for an endpoint, list all projects in a workspace, or summarize the latest activity logs. You get to stay in your IDE or chat window while the agent handles the navigation of your Stoplight assets.
What Vinkius changes
That your API documentation becomes a searchable, actionable knowledge base for your AI agent.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Checking a schema
An engineer asks the agent for the processing endpoint schema.
- Real-world use case 02
Permission Audit
A manager asks who is editing the core billing API.
- Real-world use case 03
Project Discovery
A new developer asks what projects exist in the workspace.
Complete set · 7capabilities
The complete Stoplight capability set.
These are the exact actions your AI can choose when you ask it to work with Stoplight.
01—04
4 capabilities in this set.
Part of 7 available through Stoplight.
- 01 Capability
Get node details
Pull the raw details for a specific documentation node. Use this to get the exact schema or text for a specific endpoint.
- 02 Capability
List workspace activity
View the latest logs for your workspace. Use this to see who changed what and when.
- 03 Capability
List workspace members
See everyone who has access to a workspace. This is useful for auditing permissions and team roles.
- 04 Capability
List project nodes
See every file, endpoint, and model in a project. This is great for mapping out a large API's structure.
05—07
3 capabilities in this set.
Part of 7 available through Stoplight.
- 05 Capability
List workspaces
See all workspaces you have access to. This helps you manage multiple organizational containers.
- 06 Capability
List projects
List all projects in a workspace. Use this to quickly navigate between different API products.
- 07 Capability
Get project details
Get the full metadata for a specific project. This helps you see the high-level status and description of an API repository.
Set up in minutes
One URL. Then ask Stoplight to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Stoplight from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_aafvDKV5H0XnKaJJQxGGJwn6mIM7hALMzWdPNAou/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Stoplight, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Stoplight for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_aafvDKV5H0XnKaJJQxGGJwn6mIM7hALMzWdPNAou/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Stoplight URL.
- Step 03
Save and start
Save the connection and enable Stoplight in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"stoplight": {
"url": "https://edge.vinkius.com/vk_preview_aafvDKV5H0XnKaJJQxGGJwn6mIM7hALMzWdPNAou/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Stoplight
Open Agent mode in chat and ask: "Using Stoplight, help me...". 7 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"stoplight": {
"url": "https://edge.vinkius.com/vk_preview_aafvDKV5H0XnKaJJQxGGJwn6mIM7hALMzWdPNAou/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Stoplight
Ask Copilot: "Using Stoplight, help me...". 7 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"stoplight": {
"url": "https://edge.vinkius.com/vk_preview_aafvDKV5H0XnKaJJQxGGJwn6mIM7hALMzWdPNAou/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Stoplight
Open Cascade and ask: "Using Stoplight, help me...". 7 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"stoplight": {
"url": "https://edge.vinkius.com/vk_preview_aafvDKV5H0XnKaJJQxGGJwn6mIM7hALMzWdPNAou/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Stoplight
Ask Cline: "Using Stoplight, help me...". 7 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add stoplight --transport http "https://edge.vinkius.com/vk_preview_aafvDKV5H0XnKaJJQxGGJwn6mIM7hALMzWdPNAou/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Stoplight
Ask Claude: "Using Stoplight, show me...". 7 tools are ready
Where the request belongs
Work Stoplight can move forward.
API teams who are drowning in documentation and need a way to query it without manual searching. It's for the engineers who want to know the schema without opening a browser.
API Architect
Reviews OpenAPI models and audits project governance without leaving the workspace.
Technical Writer
Summarizes updates from activity logs to create release notes and documentation updates.
Backend Engineer
Checks integration dependencies across different projects quickly during the development cycle.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsSuperblocks
Build and manage internal capabilities and workflows. list applications, manage configurations, and generate secure embed tokens directly from your AI agent.
Apiary
Manage your API design-first workflows via Apiary. read blueprints, publish docs, and run tests directly from your AI agent.
Archbee
Manage documentation spaces, sync OpenAPI specs, and organize technical knowledge directly from your AI agent.
SwaggerHub
Connect your AI to SwaggerHub. Read OpenAPI specifications, explore domains, and manage your API design lifecycle natively from the terminal.
Retool
Connect your AI assistant to Retool to inspect applications, audit users, review connected resources, and monitor workflows directly from chat.
Unleash (Feature Toggles)
Manage feature flags, strategies, and environments via Unleash. evaluate toggles, list projects, and monitor metrics directly from your AI agent.
Bring your own AI
Change the model, client or framework. Keep Stoplight connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Stoplight.
The practical details behind the request, access and result.
Can the Stoplight MCP help me find specific API endpoints?
Yes, it can query your project nodes to find specific endpoints, models, and files within your documentation.
How does the Stoplight MCP handle multiple workspaces?
It can list all the workspaces you have access to, allowing your agent to navigate between different organizational containers.
Can my agent use Stoplight MCP to see who updated the docs?
Yes, it pulls the recent activity logs for your workspace so you can see who made changes and when.
Does the Stoplight MCP support OpenAPI schemas?
Yes, it retrieves the raw text and specific details for your documentation nodes, which include OpenAPI models and schemas.
Is the Stoplight MCP good for auditing team permissions?
It's great for that. It can list all members of a workspace, showing you who has access and what roles they hold.
Can I use the Stoplight MCP to get raw JSON for a specific API?
Yes, by requesting details for a specific node, the agent can pull the raw text and schema information directly.
Is the integration read-only?
Yes. All capabilities only read from your Stoplight workspace. projects, nodes, schemas, and activity logs. No modifications or deletions are possible through this integration.
What is the workspace slug?
It's the subdomain of your Stoplight URL. For example, if your workspace is at https://acme.stoplight.io, the slug is acme. You can find it in the address bar when logged in.
What data can the agent access?
Projects, workspace members, activity logs, and all project nodes (endpoints, models, articles). Each node's full content. including OpenAPI schemas. can be retrieved via get_node_details.
One connection away
Give your agent a direct line to Stoplight.
Connect Stoplight once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available