Hugging Face Hub API
Hugging Face Hub API for searching and retrieving public machine-learning models, datasets, spaces, repository metadata, and related Hub resources.
Connect this API to an AI agent Browse all specs
What you can do with Hugging Face Hub API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /models |
get_models | Search and list models Method: GET Path: /models IMPORTANT: This function has 0 REQUIRED parameter(s) and 4 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - search: Model search text - author: Filter by author or organization - limit: Maximum number of results - sort: Sort field |
| GET | /models/{repo_id} |
get_models_repo_id | Get model metadata Method: GET Path: /models/{repo_id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - repo_id: Model repository ID such as `google/gemma-2b` |
| GET | /datasets |
get_datasets | Search and list datasets Method: GET Path: /datasets IMPORTANT: This function has 0 REQUIRED parameter(s) and 3 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - search: Dataset search text - author: Filter by author or organization - limit: Maximum number of results |
| GET | /datasets/{repo_id} |
get_datasets_repo_id | Get dataset metadata Method: GET Path: /datasets/{repo_id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - repo_id: Dataset repository ID |
| GET | /spaces |
get_spaces | Search and list Spaces Method: GET Path: /spaces IMPORTANT: This function has 0 REQUIRED parameter(s) and 3 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - search: Space search text - author: Filter by author or organization - limit: Maximum number of results |
Usage guide
Create a read-scoped access token in Hugging Face Settings > Access Tokens. Send it as `Authorization: Bearer hf_xxx`; many public discovery endpoints work without a token, while private or gated repositories require an appropriate token and permissions. Never expose the token in client-side code. Official documentation: https://huggingface.co/docs/hub/api
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Hugging Face Hub API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.