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 Connector for Claude

A+

Explore AI models, datasets and Spaces via Hugging Face — search models, inspect files, review discussions and track collections from any AI agent.

13 tools Official Updated Jun 28, 2026 Official Vinkius Partner

More Details Connect to Claude

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

Subscribe to this server
Enter your Hugging Face Access Token
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

model-discoverymachine-learningdatasetsmodel-metadataai-researchpipeline-tasks

13 tools expose this connector's capabilities to your AI agent.

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

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

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_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

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

Related Connectors

Country Data Resolver MCP

1 tools Official

Resolve ISO country codes to full names, alpha-3, and numeric codes in 4 languages. Essential for CRM and international data.

A+ View details →

LeanCloud MCP

10 tools Official

Scalable backend-as-a-service platform — manage data classes, users, and push notifications via AI.

A+ View details →

Katana MCP

11 tools Official

Automate manufacturing ERP workflows, sales orders, and inventory via Katana Cloud Manufacturing.

A+ View details →

No2Bounce MCP

2 tools Official

Validate email addresses in bulk to reduce bounce rates and protect your sender reputation directly from your AI agent.

A+ View details →