Hugging Face
co.huggingface/hf-mcp-serverVersion 0.2.33Connect to Hugging Face Hub and thousands of Gradio AI Applications
Status
Responds122 msAnswered our handshake without sign-in.- Last checked
- Nov 14, 2026, 13:44 UTC
- Latency
- 122 ms
- Remotes responding
- 2 of 2
- Sign-in
- OAuth sign-in, No sign-in
- Hosting
- EU hosting detected (detected, not a legal statement)
- Registry data as of
- Nov 14, 2026, 22:14 UTC
Data from the official MCP Registry, checked by run.zero. How we check
Connect
Streamable HTTP
https://huggingface.co/mcpResponds129 msNo sign-in
Claude Code
claude mcp add --transport http hf-mcp-server https://huggingface.co/mcpClaude Desktop and claude.ai
Settings > Connectors > Add custom connector
Name: hf-mcp-server
Remote MCP server URL: https://huggingface.co/mcpCursor
{
"mcpServers": {
"hf-mcp-server": {
"url": "https://huggingface.co/mcp"
}
}
}VS Code
code --add-mcp '{"name":"hf-mcp-server","type":"http","url":"https://huggingface.co/mcp"}'Streamable HTTP
https://huggingface.co/mcp?loginSign-in required122 msOAuth sign-in
Claude Code
This server asks for sign-in. Your client opens the sign-in when it connects.
claude mcp add --transport http hf-mcp-server 'https://huggingface.co/mcp?login'Claude Desktop and claude.ai
Settings > Connectors > Add custom connector
Name: hf-mcp-server
Remote MCP server URL: https://huggingface.co/mcp?loginCursor
{
"mcpServers": {
"hf-mcp-server": {
"url": "https://huggingface.co/mcp?login"
}
}
}VS Code
code --add-mcp '{"name":"hf-mcp-server","type":"http","url":"https://huggingface.co/mcp?login"}'Built your own server? run.zero hosts MCP servers on European infrastructure.
Tools
4 tools
Read-only | Idempotent | Open world | ||
|---|---|---|---|---|
hf_fsWhen to use: Hugging Face Hub models, datasets, Spaces, collections, papers, daily papers, today's trending models, current paper leaderboard, docs; list and read repository files, model and dataset cards (README, license).
Examples:
{"operations":[{"cmd":"ls","args":["hf://models/trending","--limit","10"]}]}
{"operations":[{"cmd":"ls","args":["hf://papers/trending"]}]}
{"operations":[{"cmd":"ls","args":["hf://papers/daily/latest"]}]}
{"operations":[{"cmd":"cat","args":["hf://papers/2501.00001/paper.md"]}]}
{"operations":[{"cmd":"search","args":["hf://models","--tag","base_model:finetune:org/repo"]}]}
Use hf_fs for Hugging Face Hub filesystem operations. Call it with operations, an array of {cmd, args} items; multiple operations may be submitted together.
Usage:
{"operations":[{"cmd":"ls","args":["hf://models/org/repo"]}]}
Grammar; each string below is one args array item:
ls URI [--recursive] [--glob GLOB] [--type TYPE] [--sort SORT] [--limit N]
cat URI [--offset N] [--max-bytes N]
attach URI [--max-bytes N]
stat URI
find URI [--name GLOB] [--path GLOB] [--type TYPE] [--limit N]
search URI [QUERY] [--type TYPE] [--sort SORT] [--tag TAG] [--kind mcp] [--limit N]
COMMAND = ls|cat|attach|stat|find|search.
TYPE = file|dir|repo|bucket|collection|paper|link.
SORT = createdAt|downloads|likes|lastModified|likes30d|trendingScore|mainSize|id|trending|upvotes.
URI is a canonical hf:// URI. QUERY and GLOB are each one string.
Use search for resource discovery, not repository-content search; ls for a known directory, find for recursive file discovery by name/path (not file contents), stat for filesystem metadata or an uncertain target type, cat for text contents, and attach for a complete JPEG, PNG, or WebP image. When the request gives an exact text-file URI, use cat directly; do not add ls or stat first. stat does not read the contents of JSON, Markdown, or other text files.
Search scopes: hf://models[/OWNER], hf://datasets[/OWNER], h | No | Yes | No | Yes |
hf_whoamiInspect the current Hugging Face authentication context, including the account, visible organization memberships, and credential access details. Read-only and never returns credential values. | No | Yes | No | No |
hub_repo_detailsGet details for one or more Hugging Face repos (model, dataset, or space): card metadata, license, downloads, files, Space hardware/status, dataset configs, splits, columns and preview rows. Auto-detects type unless specified. For datasets, use operations: overview, dataset_structure, dataset_preview. Use dataset_structure first to discover configs, splits, sizes, and schema. Use dataset_preview only when config and split are known, unless the dataset has a single config/split. | No | Yes | No | Yes |
hub_repo_searchSearch and list Hugging Face models, datasets and Spaces (sort by downloads, likes, trending) with a shared query interface. You can target models, datasets, spaces, or aggregate across multiple repo types in one call. Include links to repositories in your response. | No | Yes | No | Yes |
Details
- Registry status
- Active
- Published
- Oct 22, 2025
- Updated
- Oct 22, 2025
- Website
- Not given
- Repository
- Not given
- Categories (suggested)
- AI modelsSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
- GDPR
- Not declared