How do I get a Hugging Face Access Token?

Log in to [**Hugging Face**](https://huggingface.co), go to **Settings > Access Tokens**, click **New token**, give it a name and select scopes (read is sufficient for browsing, write if you need to create repos). Copy the token immediately — it starts with `hf_`.

Can I search models by task type (e.g. text-generation)?

Yes! Use `list_models` with a search query. While the search endpoint doesn't directly filter by pipeline_tag, you can search by task name (e.g. search='text-generation') and then use `get_model` or `get_model_tags` to verify the pipeline_tag of specific models.

Can I see what files are in a model repository?

Yes! Use `list_model_files` with the model ID (e.g. 'google-bert/bert-base-uncased') to see the complete file tree including model weights (.safetensors, .bin), config files, tokenizer files and README. Optionally set a path to browse a specific subdirectory like 'onnx' or 'pytorch'.

Can I create discussions on model pages?

Yes! Use `create_discussion` with the repo type ('model', 'dataset' or 'space'), the repo ID and a title. This creates a new discussion thread on the repository. You can use `list_model_discussions` first to check existing threads before creating a new one.

Hugging Face MCP Server for Google ADK 13 tools — connect in under 2 minutes

Name: Hugging Face
Availability: InStock
Author: Vinkius

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

Built by Vinkius GDPR 13 Tools SDK

Google Agent Development Kit (ADK) is Google's framework for building production AI agents. Add Hugging Face as an MCP tool provider through the 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="hugging_face_agent",
    instruction=(
        "You help users interact with Hugging Face "
        "using 13 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 Hugging Face MCP Server

Connect your Hugging Face account to any AI agent and explore the world's largest AI model hub through natural conversation.

Google ADK natively supports Hugging Face as an MCP tool provider — declare the Vinkius Edge URL and the framework handles discovery, validation, and execution automatically. Combine 13 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

Model Discovery — Search and browse thousands of models by name, task type, framework and author
Model Inspection — View model metadata including pipeline task, tags, download counts, likes and file structure
Dataset Exploration — Find and inspect datasets with their descriptions, sizes and file trees
Spaces Gallery — Browse ML demo apps (Gradio, Streamlit, Docker) and check their runtime status
Collections — View curated collections of models, datasets and spaces organized by topic
Community Discussions — Read model discussion threads for bug reports, feature requests and usage tips
File Tree Browsing — List repository files (model weights, configs, tokenizers) without downloading

The Hugging Face MCP Server exposes 13 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 Hugging Face to Google ADK via MCP

Follow these steps to integrate the Hugging Face 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 13 tools from Hugging Face via MCP

Why Use Google ADK with the Hugging Face MCP Server

Google ADK provides unique advantages when paired with Hugging Face 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 Hugging Face

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 Hugging Face tools with BigQuery, Vertex AI, and Cloud Functions

Hugging Face + Google ADK Use Cases

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

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

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

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

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

Hugging Face MCP Tools for Google ADK (13)

These 13 tools become available when you connect Hugging Face to Google ADK via MCP:

create_discussion

Requires the repo type (model, dataset or space), the repo ID in "author/name" format and the discussion title. Returns the created discussion with its ID, title and URL. Create a new discussion on a Hugging Face repo

get_collection

Provide the collection slug. Get details for a specific Hugging Face collection

get_model

Provide the model ID in "author/name" format (e.g. "google-bert/bert-base-uncased"). Get details for a specific Hugging Face model

get_model_tags

Tags include framework (pytorch, tensorflow), license, dataset, language and task-specific labels. The pipeline_tag indicates the model's primary task (e.g. "text-generation", "image-classification", "translation"). Get tags and pipeline info for a Hugging Face model

get_space

Provide the space ID in "author/name" format. Get details for a specific Hugging Face Space

get_user

Returns user name, avatar, organizations, auth type, plan and access tokens metadata. Use this to verify your token is working correctly. Get the authenticated Hugging Face user

list_collections

Optionally filter by author and limit. Returns collection slug, title, description, author, item count and likes count. List collections on Hugging Face Hub

list_dataset_files

Returns filenames (e.g. "train.parquet", "test.parquet", "data/", "README.md"). Optionally set a subdirectory path. Useful for understanding dataset structure before downloading. List files in a Hugging Face dataset repository

list_datasets

Optionally filter by search term, author and limit. Returns dataset ID, author, description, download count, likes count and creation date. List datasets on Hugging Face Hub

list_model_discussions

Returns discussion title, author, creation date, number of comments and whether it is resolved. Use this to review community feedback, bug reports and feature requests for a model. List discussions for a Hugging Face model

list_model_files

Returns filenames, file sizes and paths (e.g. "model.safetensors", "tokenizer.json", "config.json", "README.md"). Optionally set a subdirectory path to list files within a specific folder. Useful for inspecting model artifacts and understanding the repository structure. List files in a Hugging Face model repository

list_models

Optionally filter by search term (free-text across model cards), author (organization or username) and limit the number of results. Returns model ID, author, pipeline task tag, download count, likes count and creation date. List models on Hugging Face Hub

list_spaces

Optionally filter by search term, author and limit. Returns space ID, title, author, SDK (Gradio, Streamlit, Docker), likes count and creation date. List Spaces on Hugging Face Hub

Example Prompts for Hugging Face in Google ADK

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

"Find popular text generation models with over 1000 likes."

"Show me what files are in the bert-base-uncased model."

"What discussions are happening on the Llama-3 model page?"

Troubleshooting Hugging Face MCP Server with Google ADK

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

McpToolset not found

Update: pip install --upgrade google-adk

Hugging Face + Google ADK FAQ

Common questions about integrating Hugging Face 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.