Swaggerhub MCP integration
Finds APIs and domains, returns a chosen version's OpenAPI definition as JSON or YAML, and grants or revokes team and user access on it.
49actions available
Three actions you can hand over today
Every action runs live through MCP. Nothing to build, nothing to maintain.
Add access control for teams
Ayro assigns access control roles to teams on a SwaggerHub resource. Teams can control who sees APIs and manages permissions without manual admin interventions.
Search apis
Ayro searches SwaggerHub APIs and returns matching results based on the query. Support agents can help customers find relevant APIs in a large catalog quickly.
Get user organizations
Ayro retrieves all organizations that a user belongs to in SwaggerHub. Support staff can see the complete organizational structure for access control and billing purposes.
How businesses use Swaggerhub + Ayro
Each card is one request a support team gets, and the Swaggerhub actions Ayro runs to close it.
Find the API definition someone is asking about
Ayro searches SwaggerHub by name across APIs, domains, and templates, lists the versions that exist for a match, and confirms which one is the default before quoting anything from it.
Search APIs and DomainsGet API VersionsGet API Default VersionReturn the spec in the format that was asked for
Ayro pulls a specific API version's OpenAPI definition and hands it back as JSON or YAML, so a developer asking about an endpoint gets the contract itself rather than a link to a portal page.
Get API DefinitionGet JSON DefinitionGet YAML DefinitionGrant or revoke access on a resource
Ayro reads who currently holds access control on an API or a domain, assigns the right role to a team or a user, and removes access that should have ended when someone changed teams.
Get Access Control UsersAdd Access Control for TeamsRemove Access Control For UsersCheck what is actually published, and to whom
Ayro reads the published status of a version and whether it is public or private, and lists the portal access requests still waiting, so nothing sits exposed or blocked by accident.
Get Lifecycle SettingsGet API Version Private SettingsGet Portal Access Requests
How it works
Get started in 3 steps
Connect once, then just ask. There is no workflow builder to learn and nothing to maintain — Ayro reads the Swaggerhub actions it has and picks the ones a request needs.
Connect Swaggerhub
Authorize the Swaggerhub account your team already uses — one consent screen, no API keys, no mapping tables. Ayro can only do what you granted that account, and you can disconnect it at any time.
Tell your agent what you need
Describe the job the way you would hand it to a teammate. Ayro maps it to the Swaggerhub actions that close it and chains as many as the request needs.
Watch it work
The agent runs the actions inside the conversation the customer is already in, so nobody copies data between tabs and your team can take over at any point.
Get started free
Swaggerhub · Ayro
What can you do in Swaggerhub without me setting anything up?
These, right away:
- Add access control for teams
- Get access control users
- Delete table of contents entry
Great, let's start with the first one.
FAQ
Everything else about Swaggerhub
Setup, permissions, and the limits of what Ayro can do inside Swaggerhub.
List Resource Types and Roles returns the resource types in an organization along with the roles assignable on each, so Ayro works from the organization's real role set rather than a name someone assumed. Get User Roles then shows what one person already holds across those resources.
Every action available in Swaggerhub
All 49 actions your agent can call on Swaggerhub, straight from the live MCP connection.
Add access control for teams
Assign access control roles to teams on a SwaggerHub resource.
Add access control for users
Assign access control roles to users on a SwaggerHub resource.
Delete table of contents entry
Delete a table of contents entry from SwaggerHub portal.
Get access control users
Retrieve the list of users assigned access control on a SwaggerHub resource.
Get API default version
Get the default version identifier of a SwaggerHub API.
Get API versions
Retrieve a list of API versions for a specific API in SwaggerHub.
Get consumer products
Get a list of products that are visible to the consumer in a SwaggerHub portal.
Get API definition
Get the OpenAPI definition of a specified API version from SwaggerHub.
Get domain default version
Retrieve the default version identifier of a SwaggerHub domain.
Get domain definition
Retrieve the OpenAPI definition of a specified domain version from SwaggerHub.
Get domain JSON definition
Retrieve the OpenAPI definition for a specified domain version in JSON format.
Get domain lifecycle settings
Get the published status for a specific domain and version in SwaggerHub.
Get domain private settings
Retrieve the visibility (public or private) of a domain version in SwaggerHub.
Get domain versions
Get a list of domain versions from SwaggerHub.
Get domain yaml definition
Retrieve the OpenAPI definition for a specified domain version in YAML format from SwaggerHub.
Get JSON API definition
Download OpenAPI definition as a JSON file from SwaggerHub Portal API.
Get JSON definition
Get the OpenAPI definition for a specified API version in JSON format.
Get lifecycle settings
Get the published status for the specified API and version.
Get organization members
Retrieve a list of organization members and their roles from SwaggerHub.
Get user organizations
Get organizations for a user.
Get organization projects v2
Get all projects of an organization in SwaggerHub.
Get owner apis
Get a list of APIs for a specified owner in SwaggerHub.
Get owner domains
Retrieve domains owned by a specific SwaggerHub user or organization.
Get portal
Retrieve information about a portal.
Get portal access requests
Retrieve access requests for a portal in SwaggerHub.
Get portal attachment
Get informational attachment metadata from SwaggerHub Portal.
Get portal product
Retrieve detailed information about a specific product resource.
Get portal products
Get products for a specific portal that match your criteria.
Get portals
Search for available portals.
Get portal templates
Get templates for a specific portal that match your criteria.
The tools Swaggerhub sits next to
Same connection, same setup. Pick the next one your team already uses.
Better stack
Checks whether a service is actually up, acknowledges and escalates open incidents, publishes status page updates, and maintains the on-call rota.
Context7 MCP
Looks up current Context7 MCP documentation and triggers updates without leaving the conversation.
Gist
GitHub Gist is a service for sharing code snippets and notes.
Nango
Reports connection and sync health, issues connect and reconnect sessions, triggers one-off syncs, and proxies authenticated provider calls.
RudderStack Transformation
Lists published transformations and libraries, creates and publishes new code, and walks back through revision history on request.
Updown.io
Reads back every configured check with its status and settings, and returns the current monitoring node list with IPv4 and IPv6 addresses.
Ready to connect Swaggerhub?
Authorize the account and your agent has all 49 actions from the first conversation.