How to integrate Swaggerhub MCP with Atomic Agent

Connect Atomic Agent to Swaggerhub MCP. List all apis i have access to, create a new api named petstore, and more using natural language, with authentication handled for you.

Swaggerhub logoSwaggerhub
Api Key

Swaggerhub is a collaborative API design and documentation platform built on OpenAPI. It accelerates API delivery, quality, and teamwork with powerful standards and workflow tools.

44 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Swaggerhub.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Swaggerhub account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Swaggerhub with

How Atomic Agent connects to Swaggerhub

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Swaggerhub to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Swaggerhub. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Swaggerhub account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Swaggerhub MCP server, and what's possible with it?

The Swaggerhub MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Swaggerhub account. It provides structured and secure access to your API catalog, OpenAPI definitions, domains, organizations, and projects, so your agent can search API assets, retrieve definitions, review versions, browse projects, and inspect owned APIs on your behalf.

  • API discovery: Have your agent search Swaggerhub for APIs by relevant terms and find the specifications your team needs.
  • Definition retrieval: Instruct your agent to retrieve a specific OpenAPI definition or domain definition for review and analysis.
  • Version review: Let the agent list the available versions of an API so you can compare releases or choose the right specification.
  • Organization and project browsing: Direct your agent to list your organizations and explore the projects within a chosen organization.
  • Unified asset search: Have your agent search across APIs, domains, and templates, or list APIs belonging to a specific owner.

Use Swaggerhub from Atomic Agent

With your account connected, ask Atomic Agent to work with Swaggerhub in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Swaggerhub action and event your agent gets out of the box.

Add Access Control for Teams

Tool to assign access control roles to teams on a SwaggerHub resource.

Add Access Control for Users

Tool to assign access control roles to users on a SwaggerHub resource.

Delete Table of Contents Entry

Delete a SwaggerHub portal table of contents entry by ID, optionally including nested entries.

Get Access Control Users

Tool to retrieve the list of users assigned access control on a SwaggerHub resource.

Get API Default Version

Tool to get the default version identifier of a SwaggerHub API.

Get API Versions

Tool to retrieve a list of API versions for a specific API in SwaggerHub.

Get Consumer Products

List products visible to a consumer in a SwaggerHub portal, with an optional access filter and pagination.

Get API Definition

Retrieve the definition of a specified SwaggerHub API version, including its endpoints, schemas, and documentation.

Get Domain Default Version

Tool to retrieve the default version identifier of a SwaggerHub domain.

Get domain definition

Tool to retrieve the OpenAPI definition of a specified domain version from SwaggerHub.

Get Domain JSON Definition

Tool to retrieve the OpenAPI definition for a specified domain version in JSON format.

Get Domain Lifecycle Settings

Tool to get the published status for a specific domain and version in SwaggerHub.

Get Domain Private Settings

Tool to retrieve the visibility (public or private) of a domain version in SwaggerHub.

Get Domain Versions

Tool to get a list of domain versions from SwaggerHub.

Get Domain YAML Definition

Tool to retrieve the OpenAPI definition for a specified domain version in YAML format from SwaggerHub.

Get lifecycle settings

Tool to get the published status for the specified API and version.

Get Organization Members

Tool to retrieve a list of organization members and their roles from SwaggerHub.

Get User Organizations

Tool to get organizations for a user.

Get Organization Projects V2

Tool to get all projects of an organization in SwaggerHub.

Get Owner APIs

Tool to get a list of APIs for a specified owner in SwaggerHub.

Get owner domains

Tool to retrieve domains owned by a specific SwaggerHub user or organization.

Get Portal

Tool to retrieve information about a portal.

Get Portal Access Requests

Retrieve paginated access requests for a SwaggerHub portal, optionally filtered by status or search query, with user, product, status, and timestamp details.

Get Portal Attachment

Tool to get informational attachment metadata from SwaggerHub Portal.

Get Portal Product

Retrieve information about a specific SwaggerHub portal product using its UUID or portal-subdomain:product-slug identifier.

Get Portal Products

Tool to get products for a specific portal that match your criteria.

Get Portals

Tool to search for available portals.

Get Portal Templates

Tool to get templates for a specific portal that match your criteria.

Get API Version Private Settings

Tool to get the visibility (public or private) of an API version.

List Resource Types and Roles

Tool to list available resource types and assignable roles for each in a SwaggerHub organization.

Get Templates

Tool to retrieve a list of templates for an owner in SwaggerHub.

Get User Roles

Retrieve a page of roles assigned to a user across resources in a SwaggerHub organization, including APIs, teams, domains, and other resources.

Get YAML Definition

Tool to get the OpenAPI definition in YAML format for the specified API version from SwaggerHub.

List Attachments

Tool to retrieve all attachments for a portal or product.

Remove Access Control for Teams

Tool to remove access control for teams from a SwaggerHub resource.

Remove Access Control For Users

Tool to remove access control for users from a SwaggerHub organizational resource.

Remove Organization Members

Tool to remove members from a SwaggerHub organization.

Search APIs

Search SwaggerHub APIs by free text and published state, with pagination and sorting.

Search APIs and Domains

Tool to search SwaggerHub APIs, domains, and templates.

Search Domains

Search SwaggerHub domains by text or published state, with pagination and sorting.

Search Published Portal

Search published content in a specific SwaggerHub portal for APIs, operations, schemas, or documents.

Update Access Control for Teams

Tool to update access control roles for teams on a SwaggerHub resource.

Update Access Control for Users

Tool to update access control roles for users on a SwaggerHub resource.

Update Portal

Tool to update specific portal information in SwaggerHub.

FAQ

Frequently asked questions

Start with Swaggerhub.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Swaggerhub tool your agent needs.Free to start.

Start building