{"source":"mcp-tools:huggingface","fetchedAt":"2026-08-08T07:44:25.633Z","stale":false,"verified":true,"data":{"tools":{"hf_fs":{"description":"Use to access the Hugging Face Hub. Navigate resources with ls, cat, find, stat, and search over hf:// URIs. Roots: hf://models, hf://datasets, hf://spaces, hf://buckets, hf://collections, hf://papers, hf://docs. For papers, ls hf://papers/ARXIV_ID to discover related resources; cat hf://papers/ARXIV_ID/paper.md or metadata.json. Documentation paths include the current version from each product's llms.txt manifest.\n\nGrammar; each token below is one args array element:\n  ls     URI [(-R|-r|-lR|-laR|--recursive)] [(-l|-a|-la|-al|--long)] [--glob GLOB]\n             [(-type|--type|--entry-type) TYPE] [--sort SORT] [(-limit|--limit) N]\n  cat    URI [RELATIVE_PATH] [(-offset|--offset) N] [(-max-bytes|--max-bytes) N]\n  stat   URI [RELATIVE_PATH]\n  find   URI [(-R|-r|--recursive)] [(-name|--name|--glob) GLOB] [(-path|--path) GLOB]\n             [(-type|--type|--entry-type) TYPE] [(-limit|--limit) N]\n  search URI [QUERY...] [(-type|--type|--entry-type) TYPE] [--sort SORT]\n                        [--tag TAG] [--kind mcp] [(-limit|--limit) N]\n\nTYPE = file|dir|repo|bucket|collection|paper|link.\nType aliases: f=file, d=dir, l=link, model|dataset|space=repo.\nSORT = createdAt|downloads|likes|lastModified|likes30d|trendingScore|mainSize|id|trending|upvotes.\nURI uses hf://, a typed shorthand such as models/OWNER/REPO, or a canonical https://huggingface.co URL. QUERY and GLOB are each one string token.\nSearch URI: hf://models|datasets|spaces[/OWNER], hf://collections[/OWNER], any hf://docs scope, or exactly hf://papers; not hf://.\nRepository and collection searches may omit QUERY to browse or filter; documentation and paper searches require it.\nSearch joins multiple positional QUERY tokens with spaces. Cat and stat join one RELATIVE_PATH token to URI.\nLong-list flags are accepted for compatibility; hf_fs listings are already structured, so they do not alter output.\nFind is already recursive, so recursive flags are accepted without altering behavior.\nSpace search: hf://spaces uses semantic search; repeat --tag to require tags, or use --kind mcp for --tag mcp-server. hf://spaces/OWNER uses owner-scoped keyword search.\nDocumentation: ls hf://docs for products; search any docs scope; use returned hf:// URIs verbatim.\nTrending listings: ls hf://models/trending, hf://datasets/trending, or hf://spaces/trending. They return up to 20 entries.\nTrending paths imply trending order; --sort trending|trendingScore is redundant but valid.\nTrending papers: ls hf://papers/trending.\nTYPE filters mixed results; omit it when the URI already fixes the result type.\nLimits and path-specific behavior are documented at hf://README.md.\nOmit --limit and --sort unless the request asks for a cap, ordering, or exhaustive results.\nNo pipes, redirects, shell expansion, or multiple commands.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["cmd","args"],"properties":{"cmd":{"enum":["ls","cat","stat","find","search"],"type":"string","description":"Command to execute."},"args":{"type":"array","items":{"type":"string"},"description":"Command arguments; each array item is one grammar token."}}}},"hf_whoami":{"description":"Inspect the current Hugging Face authentication context, including the account, visible organization memberships, and credential access details. Read-only and never returns credential values.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{}}},"hub_repo_search":{"description":"Search Hugging Face repositories with a shared query interface. You can target models, datasets, spaces, or aggregate across multiple repo types in one call. Include links to repositories in your response.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"sort":{"enum":["trendingScore","downloads","likes","createdAt","lastModified"],"type":"string","description":"Sort order (descending): trendingScore, downloads, likes, createdAt, lastModified"},"limit":{"type":"number","default":20,"maximum":100,"minimum":1,"description":"Maximum number of results to return per selected repo type"},"query":{"type":"string","description":"Search term. Leave blank and specify sort + limit to browse trending or recent repositories."},"author":{"type":"string","description":"Organization or user namespace to filter by (e.g. 'google', 'meta-llama', 'huggingface')."},"filters":{"type":"array","items":{"type":"string"},"description":"Optional hub filter tags. Applied to each selected repo type (e.g. [\"text-generation\"], [\"language:en\"], [\"mcp-server\"])."},"repo_types":{"type":"array","items":{"enum":["model","dataset","space"],"type":"string"},"default":["model","dataset"],"maxItems":3,"minItems":1,"description":"Repository types to search. Defaults to [\"model\", \"dataset\"]. space uses keyword search via /api/spaces."}}}},"hub_repo_details":{"description":"Get details for one or more Hugging Face repos (model, dataset, or space). Auto-detects type unless specified. For datasets, use operations: overview, dataset_structure, dataset_preview. Use dataset_structure first to discover configs, splits, sizes, and schema. Use dataset_preview only when config and split are known, unless the dataset has a single config/split.","inputSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["repo_ids"],"properties":{"limit":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Row count for dataset_preview. Defaults to 5 and is clamped to 1-100."},"split":{"type":"string","description":"Dataset Viewer split. Required for dataset_preview when the dataset has multiple config/split options. Discover via dataset_structure."},"config":{"type":"string","description":"Dataset Viewer config. Required for dataset_preview when the dataset has multiple config/split options. Discover via dataset_structure."},"offset":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Row offset for dataset_preview. Defaults to 0."},"repo_ids":{"type":"array","items":{"type":"string","minLength":1},"maxItems":10,"minItems":1,"description":"Repo IDs for (models|dataset/space) - usually in author/name format (e.g. openai/gpt-oss-120b)"},"repo_type":{"enum":["model","dataset","space"],"type":"string","description":"Specify lookup type; otherwise auto-detects"},"operations":{"type":"array","items":{"enum":["overview","dataset_structure","dataset_preview"],"type":"string"},"description":"Details to return. Defaults to [\"overview\"]. For datasets, prefer [\"overview\", \"dataset_structure\"] first; then call [\"dataset_preview\"] with config and split."}}}}},"server":"mcp-tools:huggingface","endpoint":"https://huggingface.co/mcp"}}