Can the agent interact with public APIs outside my specific organizational ecosystem?

Yes. Beyond listing your own API configurations, the integration includes powerful global metadata tools like `search_apis` allowing you to query keyword structures discovering public interfaces readily.

How securely does the system parse potentially heavy or oversized API configurations locally?

Yes. The integration parses large JSON configurations securely and natively, ensuring large multi-megabyte API definitions are safely parsed without memory timeouts.

Can the AI modify or publish new API specifications?

The integration is primarily read-oriented — it retrieves specs, domains, projects, and integration configs. To publish or edit specs you would use the SwaggerHub editor or its write API endpoints separately.

SwaggerHub MCP Server for Google ADK 10 tools — connect in under 2 minutes

Name: SwaggerHub
Availability: InStock
Author: Vinkius

google.github.io/adk-docs/tools/mcp-tools

Built by Vinkius GDPR 10 Tools SDK

Google Agent Development Kit (ADK) is Google's framework for building production AI agents. Add SwaggerHub as an MCP tool provider through Vinkius and your ADK agents can call every tool with full schema introspection.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import (
    StreamableHTTPConnectionParams,
)

# Your Vinkius token. get it at cloud.vinkius.com
mcp_tools = McpToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    )
)

agent = Agent(
    model="gemini-2.5-pro",
    name="swaggerhub_agent",
    instruction=(
        "You help users interact with SwaggerHub "
        "using 10 available tools."
    ),
    tools=[mcp_tools],
)

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About SwaggerHub MCP Server

Integrate SwaggerHub, the enterprise platform for API design and documentation, directly into your conversational workflows with the intelligent MCP connector. Transform your LLM into an active technical architect, empowering it to securely index, validate, and retrieve full OpenAPI specifications directly from your organizational directories. Eradicate context-switching by verifying CI/CD integration pipelines, scanning centralized API definitions, and pulling structural component domains intuitively without having to hunt through graphical interfaces.

Google ADK natively supports SwaggerHub as an MCP tool provider. declare Vinkius Edge URL and the framework handles discovery, validation, and execution automatically. Combine 10 tools with Gemini's long-context reasoning for complex multi-tool workflows, with production-ready session management and evaluation built in.

What you can do

API Cataloging & Specs — Query an entire organizational API roster using list_apis and pull exact OpenAPI JSON configurations cleanly calling get_api_version_spec.
Component Reusability Insights — Investigate generic shared definitions executing list_domains and fetch core parameters seamlessly via get_domain_details.
Project & Lifecycle Control — Map team infrastructures inspecting groupings natively with list_projects and verify operational logic by calling get_project_details.
Ecosystem Verification — Audit backend dependencies natively invoking list_api_integrations to test GitHub, AWS, and GitLab sync parameters tied to your specs.

The SwaggerHub MCP Server exposes 10 tools through the Vinkius. Connect it to Google ADK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect SwaggerHub to Google ADK via MCP

Follow these steps to integrate the SwaggerHub MCP Server with Google ADK.

Install Google ADK

Run pip install google-adk

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Create the agent

Save the code above and integrate into your ADK workflow

Explore tools

The agent will discover 10 tools from SwaggerHub via MCP

Why Use Google ADK with the SwaggerHub MCP Server

Google ADK provides unique advantages when paired with SwaggerHub through the Model Context Protocol.

Google ADK natively supports MCP tool servers. declare a tool provider and the framework handles discovery, validation, and execution

Built on Gemini models, ADK provides long-context reasoning ideal for complex multi-tool workflows with SwaggerHub

Production-ready features like session management, evaluation, and deployment come built-in. not bolted on

Seamless integration with Google Cloud services means you can combine SwaggerHub tools with BigQuery, Vertex AI, and Cloud Functions

SwaggerHub + Google ADK Use Cases

Practical scenarios where Google ADK combined with the SwaggerHub MCP Server delivers measurable value.

Enterprise data agents: ADK agents query SwaggerHub and cross-reference results with internal databases for comprehensive analysis

Multi-modal workflows: combine SwaggerHub tool responses with Gemini's vision and language capabilities in a single agent

Automated compliance checks: schedule ADK agents to query SwaggerHub regularly and flag policy violations or configuration drift

Internal tool platforms: build self-service agent platforms where teams connect their own MCP servers including SwaggerHub

SwaggerHub MCP Tools for Google ADK (10)

These 10 tools become available when you connect SwaggerHub to Google ADK via MCP:

get_api_details

Retrieves metadata for a SwaggerHub API definition

get_api_version_spec

Retrieves a specific version of a SwaggerHub API definition (OpenAPI spec)

get_domain_details

Retrieves metadata for a SwaggerHub domain

get_project_details

Retrieves details of a SwaggerHub project

list_api_integrations

Lists all CI/CD integrations configured for a SwaggerHub API

list_api_templates

Lists all available API templates on SwaggerHub

list_apis

List all API definitions owned by a SwaggerHub user or organization

list_domains

Lists all shared domains (reusable components) owned by a user or org

list_projects

Lists all projects in a SwaggerHub organization

search_apis

Search all public APIs on SwaggerHub by keyword

Example Prompts for SwaggerHub in Google ADK

Ready-to-use prompts you can give your Google ADK agent to start working with SwaggerHub immediately.

"Search for public API specifications related to 'payment gateway' on SwaggerHub."

"List all active projects in our SwaggerHub organization."

"Ensure that the 'Acme-Billing' API has AWS API Gateway integration synced currently."

Troubleshooting SwaggerHub MCP Server with Google ADK

Common issues when connecting SwaggerHub to Google ADK through the Vinkius, and how to resolve them.

McpToolset not found

Update: pip install --upgrade google-adk

SwaggerHub + Google ADK FAQ

Common questions about integrating SwaggerHub MCP Server with Google ADK.

How does Google ADK connect to MCP servers?

Import the MCP toolset class and pass the server URL. ADK discovers and registers all tools automatically, making them available to your agent's tool-use loop.

Can ADK agents use multiple MCP servers?

Yes. Declare multiple MCP tool providers in your agent configuration. ADK merges all tool schemas and the agent can call tools from any server in a single turn.

Which Gemini models work best with MCP tools?

Gemini 2.0 Flash and Pro models both support function calling required for MCP tools. Flash is recommended for latency-sensitive use cases, Pro for complex reasoning.