Apiary Connector for AI agents.
10 live capabilities
Manage API blueprints and documentation without leaving your editor.
Waiting for input…
Why people use Apiary
Apiary for Automated API Documentation Sync
This Connector changes that by making your API documentation a live part of your agent's workflow. You can tell your agent to fetch the blueprint, apply your changes, and push them back to Apiary in one go. You get a single source of truth that actually stays updated.
What Vinkius changes
You stop tab-switching and start managing your API lifecycle through direct commands.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Updating a new endpoint
A backend dev wants to add a 'refund' endpoint.
- Real-world use case 02
Fixing documentation typos
A tech writer finds a typo in a public doc.
- Real-world use case 03
Status reporting for managers
A manager needs a status report.
Complete set · 10capabilities
The complete Apiary capability set.
These are the exact actions your AI can choose when you ask it to work with Apiary.
01—04
4 capabilities in this set.
Part of 10 available through Apiary.
- 01 Capability
List apis
See every API project currently hosted in your Apiary workspace. This helps you get a quick overview of your entire portfolio.
- 02 Capability
Get api
Pull the full source code of a specific API Blueprint. You can use this to feed the latest specs into your agent for analysis.
- 03 Capability
Run tests
Trigger Dredd-style tests to validate your backend against your blueprint. This catches errors before they reach your users.
- 04 Capability
Get me
View your own authenticated user profile details. Use this to check your account status and permissions.
05—07
3 capabilities in this set.
Part of 10 available through Apiary.
- 05 Capability
List team apis
Find all API projects belonging to a specific team. It is useful for seeing what projects a specific group owns.
- 06 Capability
List teams
See all the different teams you belong to in Apiary. Use this to navigate your organization's workspace.
- 07 Capability
Get team
Pull the specific details and metadata for a single team. This helps you see the scope and members of a specific group.
08—10
3 capabilities in this set.
Part of 10 available through Apiary.
- 08 Capability
List team members
See a full list of people who are members of a specific team. This is great for managing permissions and oversight.
- 09 Capability
Publish blueprint
Update a project's Blueprint with valid Markdown or Swagger code. This ensures your live documentation stays in sync with your latest changes.
- 10 Capability
Get doc url
Grab the live documentation and mock server URLs for an API project. Use this to share the correct links with your frontend team.
Set up in minutes
One URL. Then ask Apiary to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Apiary 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_UAsHBD3gjamXcRpVpwIeIHmn77OKcfcfMA4F8oBO/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 Apiary, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Apiary for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_UAsHBD3gjamXcRpVpwIeIHmn77OKcfcfMA4F8oBO/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 Apiary URL.
- Step 03
Save and start
Save the connection and enable Apiary in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"apiary": {
"url": "https://edge.vinkius.com/vk_preview_UAsHBD3gjamXcRpVpwIeIHmn77OKcfcfMA4F8oBO/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 Apiary
Open Agent mode in chat and ask: "Using Apiary, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"apiary": {
"url": "https://edge.vinkius.com/vk_preview_UAsHBD3gjamXcRpVpwIeIHmn77OKcfcfMA4F8oBO/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 Apiary
Ask Copilot: "Using Apiary, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"apiary": {
"url": "https://edge.vinkius.com/vk_preview_UAsHBD3gjamXcRpVpwIeIHmn77OKcfcfMA4F8oBO/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 Apiary
Open Cascade and ask: "Using Apiary, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"apiary": {
"url": "https://edge.vinkius.com/vk_preview_UAsHBD3gjamXcRpVpwIeIHmn77OKcfcfMA4F8oBO/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 Apiary
Ask Cline: "Using Apiary, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add apiary --transport http "https://edge.vinkius.com/vk_preview_UAsHBD3gjamXcRpVpwIeIHmn77OKcfcfMA4F8oBO/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 Apiary
Ask Claude: "Using Apiary, show me...". 10 tools are ready
Where the request belongs
Work Apiary can move forward.
For backend engineers who hate manual doc updates, technical writers who need to sync specs quickly, and engineering leads who need a bird's-eye view of their team's API portfolio.
Backend Engineer
Refactors endpoints and pushes updated blueprints to Apiary without leaving the terminal.
Technical Writer
Audits API documentation for consistency and submits fixes directly via the agent.
Engineering Manager
Monitors team projects and checks the status of Dredd tests across multiple APIs.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsSwaggerHub
Connect your AI to SwaggerHub. Read OpenAPI specifications, explore domains, and manage your API design lifecycle natively from the terminal.
Postman
Design, test, and document APIs collaboratively with the world most popular API development platform used by millions of developers.
Insomnia (Collaborative API Design)
Manage API designs and collections via Insomnia. list organizations, projects, and files, and audit API specs.
Archbee
Manage documentation spaces, sync OpenAPI specs, and organize technical knowledge directly from your AI agent.
Apidog
Sync your Apidog workspace with your AI agent. list projects, fetch endpoint schemas, and export full OpenAPI specifications instantly.
DocBreach
Real-time documentation discovery for AI agents. Discover, read, and extract any API documentation without browser rendering or API keys.
Bring your own AI
Change the model, client or framework. Keep Apiary 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 Apiary.
The practical details behind the request, access and result.
How does the Apiary MCP help with my API documentation?
It connects your agent directly to your Apiary workspace, allowing it to read, update, and publish your blueprints. This means your documentation stays current without you having to manually edit files in a browser.
Can I use this Connector to run tests on my backend?
Yes, the Connector can trigger Dredd-style tests against your Apiary project. This lets your agent verify that your actual backend implementation matches the specifications defined in your blueprints.
Will this Connector automatically update my mock servers?
Yes, when you use the Connector to publish a new blueprint, Apiary automatically syncs your mock servers and public documentation URLs to match the new specification.
Can my agent manage my team's API projects?
The Connector allows your agent to list all APIs for a specific team, list team members, and retrieve team details. It's a way to manage your engineering ecosystem through natural conversation.
Is this Connector for anyone using Swagger?
This Connector is specifically for users of the Apiary platform who use their Markdown-based blueprints or Swagger files. It won't work with other documentation platforms.
How do I connect my Apiary account to my agent?
You just need to subscribe to the Connector and provide your Personal Apiary Token. From there, your agent can start querying your projects and performing actions.
Can the agent fetch the exact mock server endpoints for one of my APIs?
Yes. You can use the get_doc_url capability to retrieve both the public facing documentation url and the private mock server endpoint string. Your agent can immediately use this url to simulate requests internally using other modules or tests.
Am I able to update the Blueprint markup completely through the agent?
Absolutely. Instruct your AI agent to fetch the blueprint with get_api. Once read into context, prompt the agent to make your desired changes (e.g. 'Add a new POST route for user creation'). Then, instruct it to use publish_blueprint to upload the newly revised markdown.
How does the team feature list function mapping work?
Apiary enables collaboration. Utilizing list_teams, the agent finds the slugs of your organizations. Then, using list_team_apis, it fetches all collaborative APIs available for that precise team. This hierarchy avoids hallucinating random endpoint repositories.
One connection away
Give your agent a direct line to Apiary.
Connect Apiary once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available