# Hugging Face — how to use (mcp.ai)

Build, train and deploy state of the art models powered by the reference open source in machine learning.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_hugging_face?ms=1781542260000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `hugging_face_change_discussions_status`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/hugging_face`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/hugging_face/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/hugging_face/change/discussions/status` — Tool to change the status of a Hugging Face repository discussion. Use when you need to open or close discussions on models, datasets, or spaces.
  - body: { num: string, repo: string, status: string, comment?: string, namespace: string, repo_type: string }
- `POST https://api.mcp.ai/api/hugging_face/check/dataset/validity` — Tool to check whether a specific dataset is valid on Hugging Face Hub. Use when you need to determine what features (preview, viewer, search, filter, statistics) are available for a dataset.
  - body: { dataset: string }
- `POST https://api.mcp.ai/api/hugging_face/check/models/upload/method` — Tool to check if files should be uploaded through the Large File mechanism or directly. Use when preparing to upload files to a Hugging Face model repository to determine the appropriate upload method
  - body: { rev: string, repo: string, files: object[], gitIgnore?: string, namespace: string, gitAttributes?: string }
- `POST https://api.mcp.ai/api/hugging_face/check/spaces/upload/method` — Tool to check if files should be uploaded through the Large File mechanism or directly to Hugging Face Spaces. Use when preparing to upload files to a Hugging Face Space repository to determine the ap
  - body: { rev: string, repo: string, files: object[], gitIgnore?: string, namespace: string, gitAttributes?: string }
- `POST https://api.mcp.ai/api/hugging_face/claim/settings/papers/claim` — Tool to claim authorship of a paper on Hugging Face. Use when you need to associate yourself or another user with an ArXiv paper.
  - body: { paper_id: string, target_user_id?: string, claim_author_id?: string }
- `POST https://api.mcp.ai/api/hugging_face/create/ask/access` — Tool to request access to a gated repository on Hugging Face Hub. Use when you need to submit an access request for models, datasets, or Spaces that require approval. The fields required vary by repos
  - body: { repo: string, namespace: string, repo_type?: string, access_request_fields: object }
- `POST https://api.mcp.ai/api/hugging_face/create/collection` — Tool to create a new collection on Hugging Face. Use when you need to organize and curate models, datasets, spaces, papers, or other collections into a named collection.
  - body: { item?: object, title: string, private?: boolean, namespace: string, description?: string }
- `POST https://api.mcp.ai/api/hugging_face/create/datasets/branch` — Tool to create a new branch in a Hugging Face dataset repository. Use when you need to create a branch for versioning or experimentation with dataset changes.
  - body: { rev: string, repo: string, namespace: string, overwrite?: boolean, emptyBranch?: boolean, startingPoint?: string }
- `POST https://api.mcp.ai/api/hugging_face/create/datasets/commit` — Tool to create a commit in a Hugging Face dataset repository. Use when you need to add, update, or delete files in a dataset. Supports both regular files and Large File Storage (LFS) for large binary 
  - body: { rev: string, repo: string, files?: object[], summary: string, create_pr?: string, lfs_files?: object[], namespace: string, hot_reload?: string, description?: string, parent_commit?: string, deleted_entries?: object[] }
- `POST https://api.mcp.ai/api/hugging_face/create/datasets/preupload` — Tool to check if files should be uploaded via Large File Storage (LFS) or directly to a Hugging Face dataset repository. Use before uploading files to determine the correct upload method for each file
  - body: { rev: string, repo: string, files: object[], gitIgnore?: string, namespace: string, gitAttributes?: string }
- `POST https://api.mcp.ai/api/hugging_face/create/datasets/tag` — Tool to create a tag on a Hugging Face dataset repository. Use when you need to mark a specific revision with a named tag.
  - body: { rev: string, tag: string, repo: string, message?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/create/discussions` — Tool to create a new discussion on a Hugging Face repository (model, dataset, or Space). Use when you need to start a conversation, report an issue, or create a pull request discussion.
  - body: { repo: string, title: string, namespace: string, repo_type: string, description: string, pull_request?: boolean }
- `POST https://api.mcp.ai/api/hugging_face/create/discussions/comment` — Tool to create a new comment on a Hugging Face repository discussion. Use when you need to add comments or replies to discussions on models, datasets, or spaces.
  - body: { num: string, repo: string, comment: string, namespace: string, repo_type: string }
- `POST https://api.mcp.ai/api/hugging_face/create/discussions/pin` — Tool to pin or unpin a discussion on a Hugging Face repository (model, dataset, or Space). Use when you need to highlight important discussions by pinning them to the top of the list, or unpin them wh
  - body: { num: string, repo: string, pinned: boolean, namespace: string, repo_type: string }
- `POST https://api.mcp.ai/api/hugging_face/create/models/branch` — Tool to create a new branch in a Hugging Face model repository. Use when you need to create a branch for experimenting with model changes, versioning, or creating isolated development environments.
  - body: { rev: string, repo: string, namespace: string, overwrite?: boolean, empty_branch?: boolean, starting_point?: string }
- `POST https://api.mcp.ai/api/hugging_face/create/models/commit` — Tool to create a commit to a Hugging Face model repository. Use when you need to add, update, or delete files in a model repository. Supports both standard JSON and JSON-lines (NDJSON) formats. JSON-l
  - body: { rev: string, repo: string, files?: object[], summary: string, create_pr?: string, lfs_files?: object[], namespace: string, hot_reload?: string, description?: string, content_type?: string, parent_commit?: string, deleted_entries?: object[] }
- `POST https://api.mcp.ai/api/hugging_face/create/models/tag` — Tool to create a tag on a Hugging Face model repository. Use when you need to mark a specific revision with a named tag.
  - body: { rev: string, tag: string, repo: string, message?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/create/papers/comment` — Tool to create a new comment on a Hugging Face paper. Use when you need to add comments or feedback to research papers on Hugging Face.
  - body: { comment: string, paper_id: string }
- `POST https://api.mcp.ai/api/hugging_face/create/papers/comment/reply` — Tool to create a reply to a comment on a Hugging Face paper. Use when you need to respond to an existing comment on a paper discussion.
  - body: { comment: string, paper_id: string, comment_id: string }
- `POST https://api.mcp.ai/api/hugging_face/create/papers/index` — Tool to index a paper from arXiv by its ID on Hugging Face. Use when you need to make a paper searchable and accessible on the platform. Note: If the paper is already indexed, only its authors can re-
  - body: { arxiv_id: string }
- `POST https://api.mcp.ai/api/hugging_face/create/repo` — Tool to create a new repository (model, dataset, or Space) on Hugging Face Hub. Use when you need to initialize a new repository for uploading models, datasets, or deploying Spaces applications.
  - body: { sdk?: string, name: string, type?: string, private?: boolean, organization?: string }
- `POST https://api.mcp.ai/api/hugging_face/create/spaces/branch` — Tool to create a new branch in a Hugging Face space repository. Use when you need to create a branch for experimenting with space changes, versioning, or creating isolated development environments.
  - body: { rev: string, repo: string, namespace: string, overwrite?: boolean, empty_branch?: boolean, starting_point?: string }
- `POST https://api.mcp.ai/api/hugging_face/create/spaces/commit` — Tool to create a commit in a Hugging Face Space repository. Use when you need to add, update, or delete files in a Space. Supports both JSON and NDJSON (recommended) payload formats for commits.
  - body: { rev: string, repo: string, files?: object[], summary: string, createPr?: string, lfsFiles?: object[], hotReload?: string, namespace: string, contentType?: string, description?: string, parentCommit?: string, deletedEntries?: object[] }
- `POST https://api.mcp.ai/api/hugging_face/create/spaces/secrets` — Tool to create or update a secret in a Hugging Face Space. Use when you need to add or update environment variables or sensitive configuration values for a Space. This action upserts the secret, meani
  - body: { key: string, repo: string, value?: string, namespace: string, description?: string }
- `POST https://api.mcp.ai/api/hugging_face/create/spaces/tag` — Tool to create a tag on a Hugging Face space repository. Use when you need to mark a specific revision with a named tag.
  - body: { rev: string, tag: string, repo: string, message?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/create/spaces/variables` — Tool to create or update a variable in a Hugging Face Space. Use when you need to add or update environment variables or configuration values for a Space. This action upserts the variable, meaning it 
  - body: { key: string, repo: string, value?: string, namespace: string, description?: string }
- `POST https://api.mcp.ai/api/hugging_face/create/sql/console/embed` — Tool to create a SQL Console embed for querying datasets on Hugging Face. Use when you need to create a shareable SQL query interface for exploring dataset splits. The embed allows users to execute SQ
  - body: { sql: string, repo: string, title: string, views: object[], private?: boolean, repoType?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/create/webhook` — Tool to create a webhook on Hugging Face that triggers on repository or discussion events. Use when you need to receive notifications for changes to specific models, datasets, or spaces.
  - body: { url: string, secret?: string, domains: string[], watched: object[], job_source_id?: string }
- `POST https://api.mcp.ai/api/hugging_face/delete/datasets/branch` — Tool to delete a branch from a Hugging Face dataset repository. Use when you need to remove a branch that is no longer needed. This action permanently removes the specified branch from the dataset.
  - body: { rev: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/delete/datasets/tag` — Tool to delete a tag from a Hugging Face dataset. Use when you need to remove a specific tag revision from a dataset repository.
  - body: { rev: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/delete/discussions` — Tool to delete a discussion from a Hugging Face repository. Use when you need to remove a discussion that is no longer needed. This action permanently removes the specified discussion from the reposit
  - body: { num: string, repo: string, namespace: string, repo_type: string }
- `POST https://api.mcp.ai/api/hugging_face/delete/network/cidr/list` — Tool to delete a network CIDR list entry from Hugging Face Inference Endpoints. Use when you need to remove a CIDR configuration that is no longer needed. This action permanently removes the specified
  - body: { cidr_id: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/delete/notifications` — Tool to delete notifications from Hugging Face. Use when you need to remove notifications either by specific discussion IDs or by applying filters to delete multiple notifications at once. Supports ta
  - body: { p?: integer, mention?: string, paper_id?: string, repo_name?: string, repo_type?: string, article_id?: string, last_update?: string, post_author?: string, read_status?: string, apply_to_all?: boolean, discussion_ids?: string[] }
- `POST https://api.mcp.ai/api/hugging_face/delete/settings/webhooks` — Tool to delete a webhook from Hugging Face settings. Use when you need to remove a webhook configuration that is no longer needed.
  - body: { webhookId: string }
- `POST https://api.mcp.ai/api/hugging_face/delete/spaces/branch` — Tool to delete a branch from a Hugging Face space repository. Use when you need to remove a branch that is no longer needed. This action permanently removes the specified branch from the space.
  - body: { rev: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/delete/spaces/secrets` — Tool to delete a secret from a Hugging Face space. Use when you need to remove sensitive credentials or configuration values that are no longer needed. This action permanently removes the specified se
  - body: { key: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/delete/spaces/tag` — Tool to delete a tag from a Hugging Face space. Use when you need to remove a specific tag revision from a space repository.
  - body: { rev: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/delete/spaces/variables` — Tool to delete a variable from a Hugging Face space. Use when you need to remove configuration values or environment variables that are no longer needed. This action permanently removes the specified 
  - body: { key: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/filter/dataset/rows` — Tool to filter rows in a Hugging Face dataset split based on SQL-like query conditions. Use when you need to search or filter specific rows from a dataset based on column values, or to retrieve sorted
  - body: { split: string, where: string, config: string, length?: integer, offset?: integer, dataset: string, orderby?: string }
- `POST https://api.mcp.ai/api/hugging_face/generate/chat/completion` — Tool to generate a response given a list of messages in a conversational context. Supports both conversational Language Models (LLMs) and Vision-Language Models (VLMs). Compatible with OpenAI SDK.
  - body: { seed?: integer, stop?: string[], model: string, tools?: object[], top_p?: number, stream?: boolean, logprobs?: boolean, messages: object[], max_tokens?: integer, temperature?: number, tool_choice?: string, tool_prompt?: string, top_logprobs?: integer, stream_options?: object, response_format?: string, presence_penalty?: number, frequency_penalty?: number }
- `POST https://api.mcp.ai/api/hugging_face/generate/embeddings` — Tool to convert text into vector embeddings for feature extraction, semantic search, and similarity tasks. Use when you need numerical representations of text for ML applications.
  - body: { model?: string, inputs: string[] }
- `POST https://api.mcp.ai/api/hugging_face/get/daily/papers` — Tool to retrieve daily papers from Hugging Face. Use when you need to fetch the latest AI/ML research papers shared on Hugging Face.
  - body: { p?: integer, date?: string, sort?: string, week?: string, limit?: integer, month?: string, submitter?: string }
- `POST https://api.mcp.ai/api/hugging_face/get/dataset/croissant` — Tool to get Croissant metadata about a Hugging Face dataset. Croissant is a metadata format built on schema.org aimed at describing datasets used for machine learning. Use when you need structured met
  - body: { dataset: string }
- `POST https://api.mcp.ai/api/hugging_face/get/dataset/first/rows` — Tool to get the first 100 rows of a dataset split along with column data types and features. Use when you need to preview or sample dataset content.
  - body: { split: string, config: string, dataset: string }
- `POST https://api.mcp.ai/api/hugging_face/get/dataset/info` — Tool to get general information about a dataset including description, citation, homepage, license, and features (column schemas). Use when you need to understand dataset structure, available splits, 
  - body: { config?: string, dataset: string }
- `POST https://api.mcp.ai/api/hugging_face/get/dataset/repo/info` — Tool to retrieve detailed information about a Hugging Face dataset repository. Use when you need metadata, card data, tags, downloads, likes, configurations, or other information about a specific data
  - body: { repo_id: string, revision?: string }
- `POST https://api.mcp.ai/api/hugging_face/get/dataset/rows` — Tool to retrieve a slice of rows from a Hugging Face dataset split at any given location (offset). Returns up to 100 rows at a time with complete feature type information and no truncation. Use when y
  - body: { split: string, config: string, length: integer, offset: integer, dataset: string }
- `POST https://api.mcp.ai/api/hugging_face/get/dataset/size` — Tool to get the size of a Hugging Face dataset including number of rows and size in bytes. Use when you need to determine dataset size, memory requirements, or storage needs for a specific dataset.
  - body: { dataset: string }
- `POST https://api.mcp.ai/api/hugging_face/get/dataset/statistics` — Tool to get comprehensive statistics about a dataset split including column statistics and data distribution information. Use when you need to analyze dataset composition, understand data distribution
  - body: { split: string, config: string, dataset: string }
- `POST https://api.mcp.ai/api/hugging_face/get/datasets/compare` — Tool to get a comparison (diff) between two revisions of a Hugging Face dataset. Use when you need to see what changed between dataset versions or commits.
  - body: { raw?: boolean, repo: string, compare: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/datasets/jwt` — Tool to generate a JWT token for accessing a Hugging Face dataset repository. Use when you need authenticated access to datasets, optionally with write access for spaces in dev mode, custom expiration
  - body: { repo: string, write?: string, encrypted?: string, namespace: string, expiration?: string, inference_api?: string, include_pro_status?: string }
- `POST https://api.mcp.ai/api/hugging_face/get/datasets/leaderboard` — Tool to retrieve evaluation results ranked by score for a dataset's leaderboard. Use when you need to compare model performance on a specific dataset or task. Returns an array of leaderboard entries w
  - body: { repo: string, task_id?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/datasets/notebook` — Tool to get a Jupyter notebook URL from a Hugging Face dataset repository. Use when you need to retrieve the URL for a specific .ipynb file from a dataset at a particular revision.
  - body: { rev: string, path: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/datasets/resolve` — Tool to resolve and download a file from a Hugging Face dataset repository. This endpoint requires following redirections to retrieve file content or returns XET file info when Accept header is set ap
  - body: { rev: string, path: string, repo: string, Range?: string, Accept?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/datasets/scan` — Tool to retrieve the security scan status of a Hugging Face dataset repository. Use when you need to check for malware, pickle vulnerabilities, or other security issues in a dataset.
  - body: { repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/datasets/tags/by/type` — Tool to retrieve all possible tags used for datasets on Hugging Face, grouped by tag type. Use when you need to discover available dataset classification tags, filter options, or metadata categories. 
  - body: { type?: string }
- `POST https://api.mcp.ai/api/hugging_face/get/datasets/treesize` — Tool to get the total size of a Hugging Face dataset repository at a specific revision and path. Use when you need to determine storage requirements or track repository size changes.
  - body: { rev: string, path?: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/datasets/xet/read/token` — Tool to get a read short-lived access token for XET from Hugging Face datasets. Use when you need temporary read access to dataset content through XET protocol.
  - body: { rev: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/discussion` — Tool to get detailed information about a specific discussion or pull request on Hugging Face Hub. Use when you need to retrieve all comments, status changes, events, and for PRs, the diff information.
  - body: { repo_id: string, repo_type: string, discussion_num: integer }
- `POST https://api.mcp.ai/api/hugging_face/get/discussions` — Tool to retrieve discussion details from a Hugging Face repository. Use when you need to get information about a specific discussion or pull request, including comments, events, and status.
  - body: { num: string, repo: string, namespace: string, repo_type: string }
- `POST https://api.mcp.ai/api/hugging_face/get/jobs/hardware` — Tool to retrieve available hardware configurations for Hugging Face Jobs with their specifications and pricing. Use when you need to discover compute options for running jobs.
- `POST https://api.mcp.ai/api/hugging_face/get/model/info` — Tool to retrieve detailed information about a Hugging Face model repository. Use when you need comprehensive metadata including downloads, likes, tags, configuration, files, and more.
  - body: { repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/model/tags/by/type` — Tool to retrieve all possible tags used for Hugging Face models, grouped by tag type. Use when you need to discover available model tags for filtering or categorization. Optionally restrict results to
  - body: { type?: string }
- `POST https://api.mcp.ai/api/hugging_face/get/models/compare` — Tool to compare two revisions of a Hugging Face model repository. Returns a git diff showing file changes between commits. Use when you need to see what changed between model versions.
  - body: { raw?: boolean, repo: string, compare: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/models/jwt` — Tool to generate a JWT token for accessing a Hugging Face model repository. Use when you need authenticated access to models, with optional write access for spaces in dev mode, custom expiration, and 
  - body: { repo: string, write?: string, encrypted?: string, namespace: string, expiration?: string, inference_api?: string, include_pro_status?: string }
- `POST https://api.mcp.ai/api/hugging_face/get/models/notebook` — Tool to retrieve a Jupyter notebook URL from a Hugging Face model repository. Use when you need to access or display a notebook file stored in a model repository.
  - body: { rev: string, path: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/models/scan` — Tool to retrieve the security scan status of a Hugging Face model repository. Use when you need to check if a model has been scanned for security issues and view any detected problems.
  - body: { repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/models/treesize` — Tool to get the total size of a Hugging Face model repository at a specific revision and path. Use when you need to determine storage requirements or track repository size changes.
  - body: { rev: string, path?: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/models/xet/read/token` — Tool to retrieve a short-lived XET read access token for a Hugging Face model repository. Use when you need to access XET (eXtensible Tensor) data for a specific model revision.
  - body: { rev: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/organizations/avatar` — Tool to retrieve the avatar URL for a Hugging Face organization. Use when you need to get the avatar image URL for a specific organization.
  - body: { name: string, redirect?: string }
- `POST https://api.mcp.ai/api/hugging_face/get/organizations/members` — Tool to retrieve a list of members for a Hugging Face organization. Use when you need to discover who belongs to an organization, with optional filtering by search terms, email, and pagination support
  - body: { name: string, email?: string, limit?: integer, cursor?: string, search?: string }
- `POST https://api.mcp.ai/api/hugging_face/get/organizations/socials` — Tool to retrieve an organization's social media handles from Hugging Face. Use when you need to find an organization's GitHub, LinkedIn, or Twitter/X profiles. Only returns handles that the organizati
  - body: { name: string }
- `POST https://api.mcp.ai/api/hugging_face/get/resolve` — Tool to resolve a file in a Hugging Face repository. Use when you need to access files from model, dataset, or space repositories. This endpoint follows redirections (302, 307) to retrieve the actual 
  - body: { rev: string, path: string, repo: string, Range?: string, Accept?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/resolve/cache/datasets` — Tool to resolve a file from cache in a Hugging Face dataset repository. This endpoint follows redirections (302, 307) to retrieve file content or returns XET file info when Accept header is set approp
  - body: { rev: string, path: string, repo: string, Range?: string, Accept?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/resolve/cache/models` — Tool to resolve and retrieve files from the Hugging Face model cache. Use when you need to access model configuration files, tokenizer files, or other JSON metadata files from a specific model reposit
  - body: { rev: string, path: string, repo: string, Range?: string, Accept?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/resolve/cache/spaces` — Tool to resolve and retrieve a file from Hugging Face Spaces cache. Use when you need to download a file from a Space repository or get XET file information. This endpoint follows redirections (HTTP 3
  - body: { rev: string, path: string, repo: string, Range?: string, Accept?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/settings/billing/usage` — Tool to retrieve user billing usage for a given period from Hugging Face. Use when you need to check usage statistics, billing information, or resource consumption for the authenticated user or organi
  - body: { periodId?: string }
- `POST https://api.mcp.ai/api/hugging_face/get/settings/billing/usage/jobs` — Tool to retrieve Jobs usage and billing information for the current subscription period from Hugging Face. Use when you need to check compute usage, costs, or job execution details for the authenticat
- `POST https://api.mcp.ai/api/hugging_face/get/settings/billing/usage/live` — Tool to retrieve live billing usage stream from Hugging Face. Use when you need real-time updates on storage, inference, Zero GPU usage, and rate limits.
  - body: { timeout?: integer }
- `POST https://api.mcp.ai/api/hugging_face/get/settings/billing/usage/v2` — Tool to retrieve user billing usage for a custom date range from Hugging Face. Use when you need to check usage statistics or resource consumption between specific dates using Unix timestamps.
  - body: { endDate: integer, startDate: integer }
- `POST https://api.mcp.ai/api/hugging_face/get/settings/mcp` — Tool to retrieve MCP (Model Context Protocol) tools configuration for the authenticated user. Use when you need to discover available built-in tools and space-based tools configured in the user's Hugg
- `POST https://api.mcp.ai/api/hugging_face/get/settings/webhooks` — Tool to retrieve a specific webhook configuration from Hugging Face settings. Use when you need to inspect webhook details, verify webhook status, or check webhook configuration for a given webhook ID
  - body: { webhookId: string }
- `POST https://api.mcp.ai/api/hugging_face/get/space/info` — Tool to retrieve detailed information about a Hugging Face Space repository. Use when you need metadata, SDK type, hardware configuration, runtime status, or other information about a specific Space.
  - body: { repo_id: string, revision?: string }
- `POST https://api.mcp.ai/api/hugging_face/get/spaces/compare` — Tool to compare two revisions of a Hugging Face Space repository. Returns a git diff showing file changes between commits. Use when you need to see what changed between Space versions.
  - body: { raw?: boolean, repo: string, compare: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/spaces/events` — Tool to stream status updates for a Hugging Face Space using SSE protocol. Use when you need to monitor Space build stages, runtime status, or receive real-time updates about Space state changes.
  - body: { repo: string, timeout?: integer, namespace: string, session_uuid?: string }
- `POST https://api.mcp.ai/api/hugging_face/get/spaces/jwt` — Tool to generate a JWT token for accessing a Hugging Face space repository. Use when you need authenticated access to spaces, with optional write access for spaces in dev mode, custom expiration, and 
  - body: { repo: string, write?: string, encrypted?: string, namespace: string, expiration?: string, inference_api?: string, include_pro_status?: string }
- `POST https://api.mcp.ai/api/hugging_face/get/spaces/metrics` — Tool to get live metrics for a specific Space in a streaming fashion, with SSE protocol, such as current Zero-GPU usage. Use when you need real-time monitoring of Space resource utilization.
  - body: { repo: string, timeout?: integer, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/spaces/notebook` — Tool to retrieve a Jupyter notebook URL from a Hugging Face space repository. Use when you need to access or display a notebook file stored in a space.
  - body: { rev: string, path: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/spaces/resolve` — Tool to resolve and retrieve a file from a Hugging Face Space repository. Use when you need to download a file from a Space or get XET file information. This endpoint follows redirections (HTTP 302/30
  - body: { rev: string, path: string, repo: string, Range?: string, Accept?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/spaces/scan` — Tool to retrieve the security scan status of a Hugging Face space repository. Use when you need to check for malware, pickle vulnerabilities, or other security issues in a space.
  - body: { repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/spaces/treesize` — Tool to get the total size of a Hugging Face space repository at a specific revision and path. Use when you need to determine storage requirements or track repository size changes.
  - body: { rev: string, path?: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/spaces/xet/read/token` — Tool to retrieve a short-lived XET read access token for a Hugging Face Space repository. Use when you need to access XET (eXtensible Tensor) data for a specific Space revision.
  - body: { rev: string, repo: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/spaces/xet/write/token` — Tool to retrieve a short-lived XET write access token for a Hugging Face space repository. Use when you need to upload or write XET data to a specific space revision.
  - body: { rev: string, repo: string, create_pr?: integer, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/get/trending` — Tool to retrieve trending repositories from Hugging Face. Use when you need to discover popular models, datasets, or spaces that are currently trending on the platform.
  - body: { type?: string, limit?: integer }
- `POST https://api.mcp.ai/api/hugging_face/get/users/avatar` — Tool to retrieve the avatar URL for a Hugging Face user. Use when you need to get the avatar image URL for a specific user.
  - body: { redirect?: string, username: string }
- `POST https://api.mcp.ai/api/hugging_face/get/users/overview` — Tool to retrieve a comprehensive overview of a Hugging Face user's profile. Use when you need to get user statistics, organizations, activity counts, and profile information.
  - body: { username: string }
- `POST https://api.mcp.ai/api/hugging_face/get/users/socials` — Tool to retrieve a user's social media handles from Hugging Face. Use when you need to find a user's GitHub, LinkedIn, Twitter/X, or Bluesky profiles. Only returns handles that the user has publicly s
  - body: { username: string }
- `POST https://api.mcp.ai/api/hugging_face/get/whoami` — Tool to get information about the authenticated Hugging Face user including username, email, organizations, and token details. Use when you need to identify the current user from an access token or re
- `POST https://api.mcp.ai/api/hugging_face/handle/datasets/user/access/request` — Tool to handle a user's access request to a gated Hugging Face dataset. Use this to accept, reject, or update the status of access requests for repositories with gated access. Either 'user' or 'userId
  - body: { repo: string, user?: string, status: string, userId?: string, namespace: string, rejectionReason?: string }
- `POST https://api.mcp.ai/api/hugging_face/list/collections` — Tool to list collections on the Hugging Face Hub. Use when you need to discover collections of models, datasets, spaces, or papers. Collections are curated groups of repositories organized by users.
  - body: { q?: string, item?: string, sort?: string, limit?: integer, owner?: string, cursor?: string, expand?: string }
- `POST https://api.mcp.ai/api/hugging_face/list/dataset/parquet/files` — Tool to get the list of Parquet files for a dataset. Use when you need to download or access dataset files in Parquet format. Returns URLs to download Parquet files with metadata about splits, configu
  - body: { dataset: string }
- `POST https://api.mcp.ai/api/hugging_face/list/dataset/paths/info` — Tool to list detailed information about specific paths in a Hugging Face dataset repository. Use when you need to get metadata about files or directories in a dataset, including size, type, commit his
  - body: { rev: string, repo: string, paths: string, expand: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/list/dataset/splits` — Tool to get the list of subsets and splits of a dataset. Returns the available configurations and splits for a given dataset on the Hub. Use when you need to understand the structure of a dataset befo
  - body: { dataset: string }
- `POST https://api.mcp.ai/api/hugging_face/list/datasets` — Tool to list datasets on the Hugging Face Hub. Use when you need to discover or search for datasets. Supports filtering by author, search query, tags, and sorting by various properties.
  - body: { sort?: string, limit?: integer, author?: string, filter?: string, search?: string, direction?: string }
- `POST https://api.mcp.ai/api/hugging_face/list/datasets/commits` — Tool to list commits from a Hugging Face dataset repository. Use when you need to retrieve the commit history for a specific dataset branch or revision.
  - body: { p?: integer, rev: string, repo: string, limit?: integer, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/list/datasets/refs` — Tool to list all references (branches, tags, converts, pull requests) in a Hugging Face dataset repository. Use when you need to retrieve available references for a specific dataset.
  - body: { repo: string, namespace: string, include_prs?: boolean }
- `POST https://api.mcp.ai/api/hugging_face/list/datasets/tree` — Tool to list the content of a Hugging Face dataset repository tree with pagination support. Use when you need to browse or explore files and directories in a dataset repository, or to discover what da
  - body: { rev?: string, path?: string, repo: string, limit?: integer, cursor?: string, expand?: boolean, namespace: string, recursive?: boolean }
- `POST https://api.mcp.ai/api/hugging_face/list/datasets/user/access/request` — Tool to list access requests for a gated Hugging Face dataset repository. Use when you need to view pending, accepted, or rejected access requests for datasets with restricted access.
  - body: { repo: string, after?: string, limit?: integer, before?: string, status: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/list/discussions` — Tool to list discussions for a Hugging Face repository. Use when you need to retrieve discussions or pull requests for a specific model, dataset, or space.
  - body: { p?: integer, repo: string, sort?: string, type?: string, author?: string, search?: string, status?: string, namespace: string, repo_type: string }
- `POST https://api.mcp.ai/api/hugging_face/list/discussions2` — Tool to list discussions and pull requests for a Hugging Face repository. Use when you need to retrieve discussion threads, issues, or PRs with their titles, status, authors, and metadata.
  - body: { repo_id: string, repo_type: string }
- `POST https://api.mcp.ai/api/hugging_face/list/docs` — Tool to retrieve the list of available documentation from Hugging Face. Use when you need to discover available documentation resources.
- `POST https://api.mcp.ai/api/hugging_face/list/endpoints` — Tool to list Hugging Face Inference Endpoints for a specific user or organization. Use when you need to retrieve endpoints, optionally filtered by tags or name.
  - body: { tags?: string, limit?: integer, cursor?: string, search?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/list/models` — Tool to list models on the Hugging Face Hub with filtering options. Use when you need to search or discover models by author, tags, task type, or other criteria.
  - body: { full?: boolean, sort?: string, limit?: integer, author?: string, config?: boolean, filter?: string, search?: string, direction?: string }
- `POST https://api.mcp.ai/api/hugging_face/list/models/commits` — Tool to list commits from a Hugging Face model repository. Use when you need to retrieve the commit history for a specific model branch or revision.
  - body: { p?: integer, rev: string, repo: string, limit?: integer, expand?: string[], namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/list/models/paths/info` — Tool to list detailed information about specific paths in a Hugging Face model repository. Use when you need to get metadata about files or directories in a model, including size, type, commit history
  - body: { rev: string, repo: string, paths: string, expand: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/list/models/refs` — Tool to list all references (branches, tags, converts, and optionally pull requests) in a Hugging Face model repository. Use when you need to retrieve version control information for a specific model.
  - body: { repo: string, namespace: string, include_prs?: boolean }
- `POST https://api.mcp.ai/api/hugging_face/list/models/tree` — Tool to list the contents of a Hugging Face model repository tree at a specific revision and path, with pagination support. Use when you need to browse model files, explore repository structure, or na
  - body: { rev: string, path?: string, repo: string, limit?: integer, cursor?: string, expand?: boolean, namespace: string, recursive?: boolean }
- `POST https://api.mcp.ai/api/hugging_face/list/notifications` — Tool to list notifications for the authenticated Hugging Face user. Use when you need to retrieve user notifications, optionally filtered by read status, repository type, author, or other criteria.
  - body: { p?: integer, mention?: string, paperId?: string, repoName?: string, repoType?: string, articleId?: string, lastUpdate?: string, postAuthor?: string, readStatus?: string }
- `POST https://api.mcp.ai/api/hugging_face/list/repo/commits` — Tool to list commits for a Hugging Face repository. Use when you need to retrieve commit history including commit hashes, messages, authors, and timestamps for models, datasets, or spaces.
  - body: { repo_id: string, revision: string, repo_type: string }
- `POST https://api.mcp.ai/api/hugging_face/list/repo/files` — Tool to get the file tree of a Hugging Face repository with pagination support. Use when you need to browse files and folders in any repository type (model, dataset, or space), explore repository stru
  - body: { path?: string, limit?: integer, cursor?: string, expand?: boolean, repo_id: string, revision?: string, recursive?: boolean, repo_type: string }
- `POST https://api.mcp.ai/api/hugging_face/list/settings/webhooks` — Tool to list all webhooks configured in Hugging Face settings. Use when you need to retrieve webhook configurations for the authenticated user's account.
- `POST https://api.mcp.ai/api/hugging_face/list/spaces` — Tool to list Spaces on the Hugging Face Hub with filtering options. Use when you need to discover or search for ML demo applications hosted on Hugging Face.
  - body: { sort?: string, limit?: integer, author?: string, filter?: string, search?: string, direction?: string }
- `POST https://api.mcp.ai/api/hugging_face/list/spaces/commits` — Tool to list commits from a Hugging Face Space repository. Use when you need to retrieve the commit history for a specific Space branch or revision.
  - body: { p?: integer, rev: string, repo: string, limit?: integer, expand?: string[], namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/list/spaces/hardware` — Tool to retrieve available hardware configurations for Hugging Face Spaces with their specifications and pricing. Use when you need to discover compute options for running spaces.
- `POST https://api.mcp.ai/api/hugging_face/list/spaces/lfs/files` — Tool to list LFS (Large File Storage) files from a Hugging Face Space repository. Use when you need to retrieve large files stored in a Space using Git LFS.
  - body: { xet?: string, repo: string, limit?: integer, cursor?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/list/spaces/paths/info` — Tool to list detailed information about specific paths in a Hugging Face space repository. Use when you need to get metadata about files or directories in a space, including size, type, commit history
  - body: { rev: string, repo: string, paths: string, expand: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/list/spaces/refs` — Tool to list all references (branches, tags, converts, pull requests) in a Hugging Face space repository. Use when you need to retrieve available references for a specific space.
  - body: { repo: string, namespace: string, include_prs?: boolean }
- `POST https://api.mcp.ai/api/hugging_face/list/spaces/tree` — Tool to list the content of a Hugging Face space repository tree with pagination support. Use when you need to browse or explore files and directories in a space repository, or to discover what files 
  - body: { rev?: string, path?: string, repo: string, limit?: integer, cursor?: string, expand?: boolean, namespace: string, recursive?: boolean }
- `POST https://api.mcp.ai/api/hugging_face/list/vendors` — Tool to list available cloud provider vendors for Hugging Face Inference Endpoints. Use when you need to discover available infrastructure options across AWS, Azure, and GCP. Returns vendors with thei
- `POST https://api.mcp.ai/api/hugging_face/search/dataset` — Tool to search text in a dataset split on Hugging Face. Searches in columns of type string, even if values are nested in a dictionary. Use when you need to find specific text or patterns within a data
  - body: { query: string, split: string, config: string, length?: integer, offset?: integer, dataset: string }
- `POST https://api.mcp.ai/api/hugging_face/search/docs` — Tool to search Hugging Face documentation across all products and libraries. Use when you need to find information about HF tools, models, datasets, or API usage.
  - body: { q: string, limit?: integer, product?: string }
- `POST https://api.mcp.ai/api/hugging_face/search/papers` — Tool to perform hybrid semantic/full-text search on papers in Hugging Face. Use when you need to find research papers by keywords, topics, or authors.
  - body: { q?: string, limit?: integer }
- `POST https://api.mcp.ai/api/hugging_face/squash/dataset/commits` — Tool to squash all commits in a dataset ref into a single commit with the given message. Use when consolidating commit history into a single commit. WARNING: This operation is irreversible.
  - body: { rev: string, repo: string, message?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/squash/spaces/commits` — Tool to squash all commits in a space ref into a single commit with the given message. Use when consolidating commit history into a single commit. WARNING: This operation is irreversible.
  - body: { rev: string, repo: string, message?: string, namespace: string }
- `POST https://api.mcp.ai/api/hugging_face/update/datasets/settings` — Tool to update settings for a Hugging Face dataset repository. Use when you need to configure visibility, discussions, gating, or access control for a dataset.
  - body: { repo: string, gated?: string, private?: boolean, namespace: string, discussions_sorting?: string, discussions_disabled?: boolean, gated_notifications_mode?: string, gated_notifications_email?: string }
- `POST https://api.mcp.ai/api/hugging_face/update/discussions/title` — Tool to change the title of an existing discussion on a Hugging Face repository (model, dataset, or Space). Use when you need to update or correct a discussion's title.
  - body: { num: string, repo: string, title: string, namespace: string, repo_type: string }
- `POST https://api.mcp.ai/api/hugging_face/update/models/settings` — Tool to update settings for a Hugging Face model repository. Use when you need to modify repository configuration such as privacy, discussions, or gated access settings.
  - body: { repo: string, private?: boolean, namespace: string, discussionsSorting?: string, discussionsDisabled?: boolean, gatedNotificationsMode?: string, gatedNotificationsEmail?: string }
- `POST https://api.mcp.ai/api/hugging_face/update/settings/notifications` — Tool to update notification settings for the authenticated Hugging Face user. Use when you need to enable or disable various notification types such as announcements, discussions, paper digests, or pr
  - body: { notifications: object, prepaidAmount?: string }
- `POST https://api.mcp.ai/api/hugging_face/update/settings/watch` — Tool to update watch settings for your Hugging Face account. Use when you want to get notified about discussions on organizations, users, or repositories. You can add new items to watch and/or remove 
  - body: { add?: object[], delete?: object[] }
- `POST https://api.mcp.ai/api/hugging_face/update/settings/webhooks` — Tool to update an existing webhook in Hugging Face settings. Use when you need to modify webhook configuration such as watched entities, event domains, target URL, or job settings.
  - body: { job?: object, url?: string, secret?: string, domains: string[], watched: object[], webhookId: string, jobSourceId?: string }
- `POST https://api.mcp.ai/api/hugging_face/update/spaces/settings` — Tool to update settings for a Hugging Face Spaces repository. Use when you need to modify repository configuration such as privacy, discussions, or gated access settings.
  - body: { repo: string, gated?: string, private?: boolean, namespace: string, discussionsSorting?: string, discussionsDisabled?: boolean, gatedNotificationsMode?: string, gatedNotificationsEmail?: string }
- `POST https://api.mcp.ai/api/hugging_face/update/sql/console/embed` — Tool to update an existing SQL console embed for a Hugging Face dataset. Use when you need to modify the SQL query, title, or privacy settings of an existing embed.
  - body: { id: string, sql?: string, repo: string, title?: string, private?: boolean, namespace: string, repo_type: string }
- `POST https://api.mcp.ai/api/hugging_face/update/webhook/status` — Tool to enable or disable a webhook on Hugging Face. Use when you need to temporarily deactivate a webhook without deleting it, or reactivate a previously disabled webhook.
  - body: { action: string, webhookId: string }

## More
- Page: https://mcp.ai/hugging_face
- Agent spec (llms.txt): https://mcp.ai/hugging_face/llms.txt
- Postman collection: https://mcp.ai/hugging_face/postman.json