What is the Hugging Face MCP Server?

The Hugging Face MCP Server gives AI agents like Claude, ChatGPT, and Cursor direct access to Hugging Face. Explore AI models, datasets and Spaces via Hugging Face — search models, inspect files, review discussions and track collections from any AI agent. Powered by the Vinkius AI Gateway — no API keys, no infrastructure, connect in under 2 minutes.

Hugging Face MCP Server: see your AI Agent in action

AI AgentVinkiusHugging Face
You

Vinkius AI Gateway
GDPR·High Security·Kill Switch·Ultra-Low Latency·Plug and Play

Built-in capabilities (13)

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

What this connector unlocks

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

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

How it works

1. Subscribe to this server
2. Enter your Hugging Face Access Token
3. Start exploring the ML hub from Claude, Cursor, or any MCP-compatible client

No more switching to the browser to check model tags or browse discussion threads. Your AI acts as a dedicated ML researcher.

Who is this for?

  • ML Engineers — quickly find models by task type, inspect their tags and file structure, and review community discussions before integration
  • Researchers — browse datasets, explore collections and discover related models without leaving your notebook
  • Developers — check Space runtime status, review model files and find suitable models for your application via conversation

Frequently asked questions

Give your AI agents the power of Hugging Face

Access Hugging Face and 2,500+ MCP servers — ready for your agents to use, right now. No glue code. No custom integrations. Just plug Vinkius AI Gateway and let your agents work.