hf-mcp-server

huggingface
257
Connect your LLM to Hugging Face Hub and thousands of Gradio AI applications, enabling access to a vast array of AI tools and models.

Content

hf-mcp-server 8

Hugging Face MCP Server

hf_whoami

Hugging Face tools are being used by authenticated user 'chenwnejia'

No parameters required

space_search

Find Hugging Face Spaces using semantic search. IMPORTANT Only MCP Servers can be used with the dynamic_space toolInclude links to the Space when presenting the results.

Parameters (3)
query string Required

Semantic Search Query

limit number Optional

Number of results to return

mcp boolean Optional

Only return MCP Server enabled Spaces

hub_repo_search

Search Hugging Face repositories with a shared query interface. You can target models, datasets, spaces, or aggregate across multiple repo types in one call. Use space_search for semantic-first discovery of Spaces. Include links to repositories in your response.

Parameters (6)
query string Optional

Search term. Leave blank and specify sort + limit to browse trending or recent repositories.

repo_types array Optional

Repository types to search. Defaults to ["model", "dataset"]. space uses keyword search via /api/spaces.

author string Optional

Organization or user namespace to filter by (e.g. 'google', 'meta-llama', 'huggingface').

filters array Optional

Optional hub filter tags. Applied to each selected repo type (e.g. ["text-generation"], ["language:en"], ["mcp-server"]).

sort string Optional

Sort order (descending): trendingScore, downloads, likes, createdAt, lastModified

limit number Optional

Maximum number of results to return per selected repo type

paper_search

Find Machine Learning research papers on the Hugging Face hub. Include 'Link to paper' When presenting the results. Consider whether tabulating results matches user intent.

Parameters (3)
query string Required

Semantic Search query

results_limit number Optional

Number of results to return

concise_only boolean Optional

Return a 2 sentence summary of the abstract. Use for broad search terms which may return a lot of results. Check with User if unsure.

hub_repo_details

Get details for one or more Hugging Face repos (model, dataset, or space). Auto-detects type unless specified.

Parameters (2)
repo_ids array Required

Repo IDs for (models|dataset/space) - usually in author/name format (e.g. openai/gpt-oss-120b)

repo_type string Optional

Specify lookup type; otherwise auto-detects

hf_doc_search

Search and Discover Hugging Face Product and Library documentation. Send an empty query to discover structure and navigation instructions. Knowledge up-to-date as at 1 April 2026. Combine with the Product filter to focus results.

Parameters (2)
query string Required

Start with an empty query for structure, endpoint discovery and navigation tips. Use semantic queries for targetted searches.

product string Optional

Filter by Product. Supply when known for focused results

hf_doc_fetch

Fetch a document from the Hugging Face or Gradio documentation library. For large documents, use offset to get subsequent chunks.

Parameters (2)
doc_url string Required

Documentation URL (Hugging Face or Gradio)

offset number Optional

Token offset for large documents (use the offset from truncation message)

gr1_z_image_turbo_generate

Generate an image using the Z-Image model based on the provided prompt and settings. This function is triggered when the user clicks the "Generate" button. It processes the input prompt (optionally enhancing it), configures generation parameters, and produces an image using the Z-Image diffusion transformer pipeline. Returns: tuple: (gallery_images, seed_str, seed_int), - seed_str: String representation of the seed used for generation, - seed_int: Integer representation of the seed used for generation (from mcp-tools/Z-Image-Turbo)

Parameters (6)
prompt string Optional

Text prompt describing the desired image content

resolution string Optional

Output resolution in format "WIDTHxHEIGHT ( RATIO )" (e.g., "1024x1024 ( 1:1 )")

seed integer Optional

Seed for reproducible generation

steps number Optional

Number of inference steps for the diffusion process

shift number Optional

Time shift parameter for the flow matching scheduler

random_seed boolean Optional

Whether to generate a new random seed, if True will ignore the seed input