Connect Swaggerhub to AI agents

Connect Swaggerhub to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Supported Tools

run_standardization

Run Standardization Scan

Run a standardization scan against an API definition in SwaggerHub. Returns validation results including severity, rule name, and location for each error or warning. Use this to check compliance with organization style guides before publishing.

get_comments

Get Comments

Retrieve all comments and replies on a specific API or domain version in SwaggerHub. Useful for reviewing team feedback, design discussions, and review workflows around API specifications.

save_domain_definition

Save Domain Definition

Create or update a domain definition in SwaggerHub. Domains are reusable components (models, parameters, responses) that can be shared across multiple API definitions. Provide the definition in YAML format.

get_api_definition

Get API Definition

Retrieve an API definition from SwaggerHub. Returns the full OpenAPI or AsyncAPI specification for a given API version, along with its settings (published status, visibility, default version). Use this to inspect or download API specs.

manage_integrations

Manage Integrations

List, create, update, delete, or execute integrations on an API version in SwaggerHub. Integrations connect SwaggerHub to external tools like GitHub, GitLab, Bitbucket, AWS API Gateway, and more. Use the **action** field to specify the operation.

manage_projects

Manage Projects

List, create, update, or delete projects in SwaggerHub. Projects organize APIs and domains into logical groups for better team-level access control. You can also add APIs or domains to existing projects.

delete_domain

Delete Domain

Delete a domain or a specific domain version from SwaggerHub. When a version is specified, only that version is removed. When no version is specified, the entire domain and all its versions are deleted.

delete_api

Delete API

Delete an API or a specific API version from SwaggerHub. When a version is specified, only that version is removed. When no version is specified, the entire API and all its versions are deleted.

get_collaboration

Get API Collaborators

Retrieve the collaboration settings and list of collaborators for an API in SwaggerHub. Shows who has access to the API and their roles.

search_apis_and_domains

Search APIs & Domains

Search the SwaggerHub catalog for APIs and domains. Supports filtering by type (API or domain), visibility, published state, owner, and free text query. Returns paginated results with metadata including name, owner, description, and links.

update_api_settings

Update API Settings

Update settings for an API in SwaggerHub. Supports changing the default version, publishing/unpublishing a version, setting visibility (public/private), and renaming the API. Multiple settings can be updated in a single call.

get_domain_definition

Get Domain Definition

Retrieve a domain definition from SwaggerHub. Domains contain reusable components (models, parameters, responses) shared across APIs. Returns the definition for a specific version, or lists available versions if no version is specified.

save_api_definition

Save API Definition

Create or update an API definition in SwaggerHub. Provide the full OpenAPI or AsyncAPI specification in YAML format. Optionally set the version, visibility, and OAS version.

More integrations teams use with Swaggerhub

Slack

Slack: connect with bot OAuth or user OAuth. Send, update, delete, and schedule messages; list and cancel scheduled messages; open DMs and group DMs; manage conversations, members, files, reactions, pins, bookmarks, reminders, user groups, and user status; search messages and files with user scopes; and retrieve user, conversation, and workspace info.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Subscribe to real-time change events via Change Data Capture and Platform Events. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Discord

Send, edit, and delete messages in channels. Manage servers (guilds), channels, roles, members, invites, webhooks, threads, scheduled events, auto moderation rules, audit logs, application commands, and custom guild emojis. Add or remove users, assign roles, kick or ban members, and receive supported message, guild, channel, member, and inbound webhook triggers.

Technical notes for Swaggerhub

Create, retrieve, update, and delete API definitions (OpenAPI and AsyncAPI) and reusable domains in SwaggerHub's centralized registry. Manage API versions, visibility, and publishing status. Search the public and private API catalog for APIs and domains. Retrieve collaboration comments and replies on API specifications. Configure and trigger integrations with external tools like GitHub, GitLab, AWS API Gateway, and CI/CD systems. Organize APIs and domains into projects with team-level access control. Generate client SDKs and server stubs in 30+ languages. Manage organization members, roles, and permissions. Run standardization scans to validate API definitions against style guides and governance rules. Configure webhooks to receive notifications when API versions are saved or published.

Connect Swaggerhub to production AI agents

See how Metorial gives Swaggerhub access the governance, tracing, and security controls teams need.

Frequently asked questions

Common questions about connecting Swaggerhub to AI agents with Metorial.

  1. Can Metorial connect Swaggerhub to AI agents?
    Yes. Metorial connects AI agents to Swaggerhub through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.