{ "server": "huggingface", "url": "https://huggingface.co/mcp", "date": "2026-08-26", "protocolVersion": "2026-07-28", "serverInfo": { "name": "huggingface.co/mcp", "title": "Hugging Face", "version": "0.4.13", "websiteUrl": "https://huggingface.co/mcp", "icons": [ { "src": "https://huggingface.co/favicon.ico" } ] }, "listChangedDeclared": false, "toolCount": 4, "outputSchemaCoveragePct": 50, "tools": [ { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Hugging Face Hub: Find, use and view models, datasets, spaces, buckets, papers, documentation and collections. Get daily papers reports, and browse trending content. " }, "description": "When to use: Hugging Face Hub models, datasets, Spaces, collections, papers, daily papers, today's trending models, current paper leaderboard, docs, and repository files.\n\nExamples:\n {\"operations\":[{\"cmd\":\"ls\",\"args\":[\"hf://models/trending\",\"--limit\",\"10\"]}]}\n {\"operations\":[{\"cmd\":\"ls\",\"args\":[\"hf://papers/trending\"]}]}\n {\"operations\":[{\"cmd\":\"ls\",\"args\":[\"hf://papers/daily/latest\"]}]}\n\nUse hf_fs for Hugging Face Hub filesystem operations. Call it with operations, an array of {cmd, args} items; multiple operations may be submitted together.\n\nUsage:\n {\"operations\":[{\"cmd\":\"ls\",\"args\":[\"hf://models/org/repo\"]}]}\n\nGrammar; each string below is one args array item:\n ls URI [--recursive] [--glob GLOB] [--type TYPE] [--sort SORT] [--limit N]\n cat URI [--offset N] [--max-bytes N]\n attach URI [--max-bytes N]\n stat URI\n find URI [--name GLOB] [--path GLOB] [--type TYPE] [--limit N]\n search URI [QUERY] [--type TYPE] [--sort SORT] [--tag TAG] [--kind mcp] [--limit N]\n\nCOMMAND = ls|cat|attach|stat|find|search.\nTYPE = file|dir|repo|bucket|collection|paper|link.\nSORT = createdAt|downloads|likes|lastModified|likes30d|trendingScore|mainSize|id|trending|upvotes.\nURI is a canonical hf:// URI. QUERY and GLOB are each one string.\n\nUse search for discovery, ls for a known directory, find for recursive matching within a known scope, stat for filesystem metadata or an uncertain target type, cat for text contents, and attach for a complete JPEG, PNG, or WebP image. When the request gives an exact text-file URI, use cat directly; do not add ls or stat first. stat does not read the contents of JSON, Markdown, or other text files.\n\nSearch scopes: hf://models|datasets|spaces[/OWNER], hf://collections[/OWNER], hf://papers, and hf://docs[/...]. Paper and documentation search require QUERY. Repeat --tag only for search hf://spaces; --kind mcp selects MCP Spaces.\nUse ls hf://models/trending, hf://datasets/trending, hf://spaces/trending, or hf://papers/trending for trending listings.\nFor a named paper.md or metadata.json, use cat directly. Use ls on a paper only to discover an unnamed related resource.\nOmit --limit, --sort, and --type unless the request requires them. Limits and path-specific behavior are documented at hf://README.md. Issue one hf_fs call.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "operations": { "items": { "additionalProperties": false, "properties": { "args": { "description": "Command arguments; each array item is one grammar token.", "items": { "type": "string" }, "type": "array" }, "cmd": { "description": "Command to execute.", "enum": [ "ls", "cat", "attach", "stat", "find", "search" ], "type": "string" } }, "required": [ "cmd", "args" ], "type": "object" }, "maxItems": 30, "minItems": 1, "type": "array" } }, "required": [ "operations" ], "type": "object" }, "name": "hf_fs", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "results": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "index": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "output_truncated": { "type": "boolean" }, "result": { "additionalProperties": false, "allOf": [ { "if": { "properties": { "op": { "const": "attach" } }, "required": [ "op" ] }, "then": { "properties": { "bytes": { "maximum": 8388608, "minimum": 0, "type": "integer" }, "mime_type": { "enum": [ "image/jpeg", "image/png", "image/webp" ], "type": "string" }, "path": { "type": "string" } }, "required": [ "path", "mime_type", "bytes" ] } } ], "properties": { "arxiv_url": { "type": "string" }, "bytes": { "type": "number" }, "content": { "type": "string" }, "content_type": { "enum": [ "application/json", "text/markdown" ], "type": "string" }, "daily_papers_date": { "type": "string" }, "daily_papers_uri": { "type": "string" }, "entries": { "items": { "additionalProperties": false, "properties": { "anchor": { "type": "string" }, "arxiv_url": { "type": "string" }, "category": { "type": "string" }, "content_type": { "enum": [ "application/json", "text/markdown" ], "type": "string" }, "created_at": { "type": "string" }, "daily_papers_date": { "type": "string" }, "daily_papers_uri": { "type": "string" }, "description": { "type": "string" }, "downloads": { "type": "number" }, "gated": { "anyOf": [ { "const": false, "type": "boolean" }, { "enum": [ "auto", "manual" ], "type": "string" } ] }, "lfs": { "type": "boolean" }, "library": { "type": "string" }, "likes": { "type": "number" }, "name": { "type": "string" }, "observed_at": { "type": "string" }, "path": { "type": "string" }, "private": { "type": "boolean" }, "published_at": { "type": "string" }, "repo_type": { "enum": [ "model", "dataset", "space", "bucket" ], "type": "string" }, "sdk": { "type": "string" }, "semantic_relevance": { "type": "number" }, "size": { "type": "number" }, "tags": { "items": { "type": "string" }, "type": "array" }, "target_uri": { "type": "string" }, "task": { "type": "string" }, "title": { "type": "string" }, "total_files": { "type": "number" }, "trending_score": { "type": "number" }, "type": { "enum": [ "file", "dir", "repo", "bucket", "collection", "paper", "link" ], "type": "string" }, "updated_at": { "type": "string" }, "upvotes": { "type": "number" }, "uri": { "type": "string" }, "url": { "type": "string" } }, "required": [ "type", "path" ], "type": "object" }, "type": "array" }, "exists": { "type": "boolean" }, "lfs": { "type": "boolean" }, "mime_type": { "enum": [ "image/jpeg", "image/png", "image/webp" ], "type": "string" }, "namespace": { "type": "string" }, "next_offset": { "type": "number" }, "op": { "enum": [ "ls", "cat", "attach", "stat", "find", "search" ], "type": "string" }, "path": { "type": "string" }, "published_at": { "type": "string" }, "section": { "type": "string" }, "size": { "type": "number" }, "target_uri": { "type": "string" }, "truncated": { "type": "boolean" }, "truncation_message": { "type": "string" }, "truncation_reason": { "enum": [ "entry_limit", "max_bytes", "limit", "provider_limit" ], "type": "string" }, "type": { "enum": [ "namespace", "repo", "dir", "file", "collection", "paper", "link", "missing" ], "type": "string" }, "uri": { "type": "string" }, "url": { "type": "string" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "uri", "op" ], "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "index", "status", "result" ], "type": "object" }, { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "enum": [ "HF_FS_INVALID_ARGUMENT", "HF_FS_NOT_FOUND", "HF_FS_NOT_A_DIRECTORY", "HF_FS_NOT_A_FILE", "HF_FS_UNSUPPORTED_OPERATION", "HF_FS_ACCESS_DENIED", "HF_FS_TEXT_ONLY", "HF_FS_IMAGE_ONLY", "HF_FS_UNSUPPORTED_MEDIA", "HF_FS_IMAGE_TOO_LARGE", "HF_FS_ATTACHMENT_BUDGET_EXCEEDED", "HF_FS_IMAGE_CONTENT_DISABLED", "HF_FS_ATTACHMENT_INTEGRITY" ], "type": "string" }, "message": { "type": "string" }, "recovery": { "type": "string" }, "retryable": { "const": false, "type": "boolean" }, "suggestedOperation": { "enum": [ "ls", "cat", "attach", "stat", "search" ], "type": "string" } }, "required": [ "code", "message", "recovery", "retryable" ], "type": "object" }, "index": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "status": { "const": "error", "type": "string" } }, "required": [ "index", "status", "error" ], "type": "object" } ] }, "maxItems": 30, "minItems": 1, "type": "array" }, "truncated": { "type": "boolean" }, "truncation_reason": { "const": "output_budget", "type": "string" } }, "required": [ "results" ], "type": "object" }, "title": "Hugging Face Hub: Find, use and view models, datasets, spaces, buckets, papers, documentation and collections. Get daily papers reports, and browse trending content. " }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true, "title": "Hugging Face User Info" }, "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": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": {}, "type": "object" }, "name": "hf_whoami", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "account": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "is_pro": { "type": "boolean" }, "name": { "minLength": 1, "type": "string" }, "type": { "enum": [ "user", "org", "app" ], "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "id", "type", "name" ], "type": "object" }, "credential": { "oneOf": [ { "additionalProperties": false, "properties": { "created_at": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "type": "string" }, "permissions": { "additionalProperties": false, "properties": { "can_read_gated_repos": { "type": "boolean" }, "global": { "items": { "minLength": 1, "type": "string" }, "type": "array" }, "scoped": { "items": { "additionalProperties": false, "properties": { "entity": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "name": { "minLength": 1, "type": "string" }, "type": { "enum": [ "model", "dataset", "space", "bucket", "kernel", "collection", "org", "user", "resource_group", "oauth_app" ], "type": "string" } }, "required": [ "id", "type" ], "type": "object" }, "permissions": { "items": { "minLength": 1, "type": "string" }, "type": "array" }, "restrictions": { "items": { "additionalProperties": false, "properties": { "patterns": { "items": { "minLength": 1, "type": "string" }, "type": "array" }, "resource_type": { "const": "inference_endpoint", "type": "string" } }, "required": [ "resource_type", "patterns" ], "type": "object" }, "type": "array" } }, "required": [ "entity", "permissions" ], "type": "object" }, "type": "array" } }, "required": [ "scoped" ], "type": "object" }, "role": { "enum": [ "read", "write", "fine_grained" ], "type": "string" }, "type": { "const": "personal_access_token", "type": "string" } }, "required": [ "type", "role" ], "type": "object" }, { "additionalProperties": false, "properties": { "expires_at": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "type": "string" }, "scopes": { "items": { "minLength": 1, "type": "string" }, "type": "array" }, "type": { "const": "oauth", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "entities": { "items": { "additionalProperties": false, "properties": { "name": { "minLength": 1, "type": "string" }, "type": { "enum": [ "model", "dataset", "space", "bucket", "kernel", "org" ], "type": "string" } }, "required": [ "name" ], "type": "object" }, "type": "array" }, "role": { "minLength": 1, "type": "string" }, "type": { "const": "app_token", "type": "string" } }, "required": [ "type", "entities" ], "type": "object" }, { "additionalProperties": false, "properties": { "expires_at": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "type": "string" }, "type": { "const": "other", "type": "string" } }, "required": [ "type" ], "type": "object" } ] }, "organizations": { "items": { "additionalProperties": false, "properties": { "display_name": { "minLength": 1, "type": "string" }, "id": { "minLength": 1, "type": "string" }, "name": { "minLength": 1, "type": "string" }, "plan": { "minLength": 1, "type": "string" }, "resource_groups": { "items": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "name": { "minLength": 1, "type": "string" }, "role": { "minLength": 1, "type": "string" } }, "required": [ "id", "name", "role" ], "type": "object" }, "type": "array" }, "role": { "minLength": 1, "type": "string" }, "security_restrictions": { "items": { "minLength": 1, "type": "string" }, "type": "array" }, "url": { "format": "uri", "type": "string" } }, "required": [ "id", "name", "display_name", "url" ], "type": "object" }, "type": "array" }, "status": { "const": "authenticated", "type": "string" } }, "required": [ "status", "account", "organizations", "credential" ], "type": "object" }, { "additionalProperties": false, "properties": { "account": { "type": "null" }, "credential": { "type": "null" }, "guidance": { "minLength": 1, "type": "string" }, "organizations": { "items": { "additionalProperties": false, "properties": { "display_name": { "minLength": 1, "type": "string" }, "id": { "minLength": 1, "type": "string" }, "name": { "minLength": 1, "type": "string" }, "plan": { "minLength": 1, "type": "string" }, "resource_groups": { "items": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "name": { "minLength": 1, "type": "string" }, "role": { "minLength": 1, "type": "string" } }, "required": [ "id", "name", "role" ], "type": "object" }, "type": "array" }, "role": { "minLength": 1, "type": "string" }, "security_restrictions": { "items": { "minLength": 1, "type": "string" }, "type": "array" }, "url": { "format": "uri", "type": "string" } }, "required": [ "id", "name", "display_name", "url" ], "type": "object" }, "type": "array" }, "status": { "const": "anonymous", "type": "string" } }, "required": [ "status", "account", "organizations", "credential", "guidance" ], "type": "object" }, { "additionalProperties": false, "properties": { "account": { "type": "null" }, "credential": { "type": "null" }, "guidance": { "minLength": 1, "type": "string" }, "organizations": { "items": { "additionalProperties": false, "properties": { "display_name": { "minLength": 1, "type": "string" }, "id": { "minLength": 1, "type": "string" }, "name": { "minLength": 1, "type": "string" }, "plan": { "minLength": 1, "type": "string" }, "resource_groups": { "items": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "name": { "minLength": 1, "type": "string" }, "role": { "minLength": 1, "type": "string" } }, "required": [ "id", "name", "role" ], "type": "object" }, "type": "array" }, "role": { "minLength": 1, "type": "string" }, "security_restrictions": { "items": { "minLength": 1, "type": "string" }, "type": "array" }, "url": { "format": "uri", "type": "string" } }, "required": [ "id", "name", "display_name", "url" ], "type": "object" }, "type": "array" }, "status": { "const": "authentication_unverified", "type": "string" } }, "required": [ "status", "account", "organizations", "credential", "guidance" ], "type": "object" } ], "type": "object" }, "title": "Hugging Face User Info" }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "Hub Repository 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": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "config": { "description": "Dataset Viewer config. Required for dataset_preview when the dataset has multiple config/split options. Discover via dataset_structure.", "type": "string" }, "limit": { "description": "Row count for dataset_preview. Defaults to 5 and is clamped to 1-100.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "offset": { "description": "Row offset for dataset_preview. Defaults to 0.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "operations": { "description": "Details to return. Defaults to [\"overview\"]. For datasets, prefer [\"overview\", \"dataset_structure\"] first; then call [\"dataset_preview\"] with config and split.", "items": { "enum": [ "overview", "dataset_structure", "dataset_preview" ], "type": "string" }, "type": "array" }, "repo_ids": { "description": "Repo IDs for (models|dataset/space) - usually in author/name format (e.g. openai/gpt-oss-120b)", "items": { "minLength": 1, "type": "string" }, "maxItems": 10, "minItems": 1, "type": "array" }, "repo_type": { "description": "Specify lookup type; otherwise auto-detects", "enum": [ "model", "dataset", "space" ], "type": "string" }, "split": { "description": "Dataset Viewer split. Required for dataset_preview when the dataset has multiple config/split options. Discover via dataset_structure.", "type": "string" } }, "required": [ "repo_ids" ], "type": "object" }, "name": "hub_repo_details", "title": "Hub Repository Details" }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true, "title": "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": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "author": { "description": "Organization or user namespace to filter by (e.g. 'google', 'meta-llama', 'huggingface').", "type": "string" }, "filters": { "description": "Optional hub filter tags. Applied to each selected repo type (e.g. [\"text-generation\"], [\"language:en\"], [\"mcp-server\"]).", "items": { "type": "string" }, "type": "array" }, "limit": { "default": 20, "description": "Maximum number of results to return per selected repo type", "maximum": 100, "minimum": 1, "type": "number" }, "query": { "description": "Search term. Leave blank and specify sort + limit to browse trending or recent repositories.", "type": "string" }, "repo_types": { "default": [ "model", "dataset" ], "description": "Repository types to search. Defaults to [\"model\", \"dataset\"]. space uses keyword search via /api/spaces.", "items": { "enum": [ "model", "dataset", "space" ], "type": "string" }, "maxItems": 3, "minItems": 1, "type": "array" }, "sort": { "description": "Sort order (descending): trendingScore, downloads, likes, createdAt, lastModified", "enum": [ "trendingScore", "downloads", "likes", "createdAt", "lastModified" ], "type": "string" } }, "type": "object" }, "name": "hub_repo_search", "title": "Repo Search" } ] }