Bring Model Discovery
to Claude Code
Create your Vinkius account to connect Hugging Face to Claude Code and start using all 13 AI tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code. No hosting, no server setup — just connect and start using.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the 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.
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
Built-in capabilities (13)
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
Provide the collection slug. Get details for a specific Hugging Face collection
Provide the model ID in "author/name" format (e.g. "google-bert/bert-base-uncased"). Get details for a specific Hugging Face model
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
Provide the space ID in "author/name" format. Get details for a specific Hugging Face Space
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
Optionally filter by author and limit. Returns collection slug, title, description, author, item count and likes count. List collections on Hugging Face Hub
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
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
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
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
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
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
Why Claude Code?
Claude Code registers Hugging Face as an MCP server in a single terminal command. Once connected, Claude Code discovers all 13 tools at runtime and can call them headlessly. ideal for CI/CD pipelines, cron jobs, and automated workflows where Hugging Face data drives decisions without human intervention.
- —
Single-command setup:
claude mcp addregisters the server instantly. no config files to edit or applications to restart - —
Terminal-native workflow means MCP tools integrate seamlessly into shell scripts, CI/CD pipelines, and automated DevOps tasks
- —
Claude Code runs headlessly, enabling unattended batch processing using Hugging Face tools in cron jobs or deployment scripts
- —
Built by the same team that created the MCP protocol, ensuring first-class compatibility and the fastest adoption of new protocol features
Hugging Face in Claude Code
Why run Hugging Face with Vinkius?
The Hugging Face connection runs on our fully managed, secure cloud infrastructure. We handle the hosting, maintenance, and security so you don't have to deal with servers or code. All 13 tools are ready to work instantly without any complex setup.
You stay in complete control of your data. Your AI only accesses the information you approve, keeping your sensitive passwords and private details completely safe. Plus, with automatic optimizations, your AI works faster and more efficiently.
* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure
Over 4,000 integrations ready for AI agents
Explore a vast library of pre-built integrations, optimized and ready to deploy.
Connect securely in under 30 seconds
Generate tokens to authenticate and link external services in a single step.
Complete visibility into every agent action
Audit live requests, latency, success rates, and active security compliance policies.
Optimize spending and track token ROI
Analyze real-time token consumption and cost metrics detailed by connection.
Explore our live AI Agents Analytics dashboard to see it all working
This dashboard is included when you connect Hugging Face using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.
Hugging Face and 4,000+ other AI tools. No hosting, no code, ready to use.
Professionals who connect Hugging Face to Claude Code through Vinkius don't need to write code, manage servers, or worry about security. Everything is pre-configured, secure, and runs automatically in the background.
Raw MCP | Vinkius | |
|---|---|---|
| Ready-to-use MCPs | Find and configure each manually | 4,000+ MCPs ready to use |
| Connection Setup | Manual coding & server setup | 1-click instant connection |
| Server Hosting | You host it yourself (needs 24/7 uptime) | 100% hosted & managed by Vinkius |
| Security & Privacy | Stored in plaintext config files | Bank-grade encrypted vault |
| Activity Visibility | Blind execution (no logs or tracking) | Live dashboard with real-time logs |
| Cost Control | Runaway AI token spend risk | Automatic budget limits |
| Revoking Access | Must delete files or code to stop | 1-click disconnect button |
How Vinkius secures
Hugging Face for Claude Code
Every request between Claude Code and Hugging Face is protected by our secure gateway. We automatically keep your sensitive data private, prevent unauthorized access, and let you disconnect instantly at any time.
Frequently asked questions
How do I get a Hugging Face Access Token?
Log in to Hugging Face, 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.
How do I add an MCP server to Claude Code?
Run claude mcp add <name> --transport http "<url>" in your terminal. Claude Code registers the server and discovers all tools immediately.
Can Claude Code run MCP tools in headless mode?
Yes. Claude Code supports non-interactive execution, making it ideal for scripts, cron jobs, and CI/CD pipelines that need MCP tool access.
How do I list all connected MCP servers?
Run claude mcp in your terminal to see all registered servers and their status, or type /mcp inside an active Claude Code session.
Command not found: claude
Ensure Claude Code is installed globally: npm install -g @anthropic-ai/claude-code
Connection timeout
Check your internet connection and verify the Edge URL is reachable
Explore More MCP Servers
View all →
Notion Calendar (formerly Cron)
10 toolsManage scheduling via Notion Calendar — create events, track team availability, and manage scheduling links directly from any AI agent.
Discord Webhook Notifier
1 toolsThis MCP does exactly one thing: it sends messages to your Discord channels. That's its only function, and nothing else. Zero friction, incredible for giving your AI agents a voice.
Google Air Quality
2 toolsUniversal air quality intelligence — get Google-powered AQI, pollutants, and health advice via AI.
New Relic AI (LLM Observability)
10 toolsMonitor and audit LLM telemetry via New Relic AI — track token costs, p95 latency, and user feedback.