Hugging Face MCP: what works in Claude, ChatGPT, Cursor, and Grok Bot
Connect to Hugging Face Hub and thousands of Gradio AI Applications
Registry name: co.huggingface/hf-mcp-server (v0.2.33)
Set it up
URL https://huggingface.co/mcp. No sign-in. Paste the URL and it connects. Copy-paste setup: Claude | Claude Code | Cursor | VS Code | ChatGPT
Status grid
| App | Status | Date tested |
|---|---|---|
| Claude | Untested | Not yet tested |
| ChatGPT | Untested | Not yet tested |
| Cursor | Untested | Not yet tested |
| Grok Bot | Untested | Not yet tested |
| MCP Inspector (reference client) | Untested | Not yet tested |
| MCP TypeScript SDK (reference client) | Works | Fri Oct 16 2026 |
Hands-on test results
| App | Task | Result | Time | Detail | Date tested |
|---|---|---|---|---|---|
| MCP TypeScript SDK (reference client) | connect (no auth) | Works | 173 ms | Connected without sign-in. 4 tools listed in 138 ms. | Oct 16, 2026, 3:43 PM CT |
| MCP TypeScript SDK (reference client) | whoami (anonymous) | Works | 19 ms | hf_whoami: 313 characters returned. "# Hugging Face authentication The Hugging Face tools are being used anonymously and may be rate limited. Visit https://hf.co/settings/mcp/ f" | Oct 16, 2026, 3:43 PM CT |
| MCP TypeScript SDK (reference client) | search models ("whisper") | Works | 40 ms | hub_repo_search: about 2 KB returned. "Found 5 repositories across models matching query "whisper". ## Models (5) ### openai/whisper-large-v3 **Task:** automatic-speech-recognitio" | Oct 16, 2026, 3:43 PM CT |
| MCP TypeScript SDK (reference client) | repo details (openai/whisper-large-v3) | Works | 39 ms | hub_repo_details: about 3 KB returned. "**Type: Model** # openai/whisper-large-v3 ## Overview - **Author:** openai - **Task:** automatic-speech-recognition - **Library:** transform" | Oct 16, 2026, 3:43 PM CT |
| MCP TypeScript SDK (reference client) | search with no matches | Works | 32 ms | hub_repo_search: 45 characters returned. "No repositories found for the given criteria." | Oct 16, 2026, 3:43 PM CT |
| MCP TypeScript SDK (reference client) | error handling (malformed args) | Works | 13 ms | hub_repo_details: tool error, 125 characters returned. "Input validation error: Invalid arguments for tool hub_repo_details: repo_ids: Invalid input: expected array, received string" | Oct 16, 2026, 3:43 PM CT |
Oct 16, 2026, 3:43 PM CT, MCP TypeScript SDK (reference client): Scripted client using the official MCP TypeScript SDK v1.32.1 against https://huggingface.co/mcp (Streamable HTTP, protocol 2025-11-25). Connected anonymously to https://huggingface.co/mcp (no token). Server huggingface.co/mcp v0.4.30. Read-only server, so no create task. 5 of 5 tasks passed.
Automated handshake
No public remote endpoint to check (local or package-only server).
Gotchas
- MCP TypeScript SDK (reference client): Anonymous use works, but hf_whoami warns you may be rate limited. Add a free HF token for heavier use.
- MCP TypeScript SDK (reference client): Download counts differ between tools: search showed 3.7M (recent) while details showed 150.4M (all time) for the same model.
Errors and fixes
FAQ
Does the Hugging Face MCP server work?
In our hands-on test on Oct 16, 2026, 6 of 6 tasks passed. Main gotcha: Anonymous use works, but hf_whoami warns you may be rate limited. Add a free HF token for heavier use.
What is the Hugging Face MCP server URL?
https://huggingface.co/mcp (Streamable HTTP).
Does the Hugging Face MCP server need sign-in?
No sign-in. Paste the URL and it connects.
How do I add the Hugging Face MCP server to Claude, Cursor, VS Code or ChatGPT?
Follow our copy-paste setup guides: https://connectorreport.com/c/co-huggingface-hf-mcp-server/setup/claude https://connectorreport.com/c/co-huggingface-hf-mcp-server/setup/claude-code https://connectorreport.com/c/co-huggingface-hf-mcp-server/setup/cursor https://connectorreport.com/c/co-huggingface-hf-mcp-server/setup/vscode https://connectorreport.com/c/co-huggingface-hf-mcp-server/setup/chatgpt
What errors does the Hugging Face MCP server give?
Hugging Face MCP: "used anonymously and may be rate limited".
Compare with other tested connectors | Connector Weather
Request a hands-on test of Hugging Face
Get the badge
Maintain Hugging Face or write about it? Show its live ConnectorReport status in your README or docs.
Markdown (README, docs)
[](https://connectorreport.com/c/co-huggingface-hf-mcp-server?utm_source=badge&utm_medium=embed&utm_campaign=co-huggingface-hf-mcp-server)
HTML
<a href="https://connectorreport.com/c/co-huggingface-hf-mcp-server?utm_source=badge&utm_medium=embed&utm_campaign=co-huggingface-hf-mcp-server"><img src="https://connectorreport.com/badge/co-huggingface-hf-mcp-server.svg" alt="Hugging Face MCP status on ConnectorReport"/></a>
The badge updates on its own after every retest. How badges work