Hugging face MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'huggingfacemcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Hugging face MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'huggingfacemcp_hf_whoami',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "huggingfacemcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Hugging face MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="huggingfacemcp_hf_whoami",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Search space, paper, hub repo — Search Hugging Face Spaces by query and return matching spaces with relevance scores
• Details hub repo — Retrieve details for one or more Hugging Face Hub repositories by their IDs
• Whoami hf — Return the currently authenticated Hugging Face user’s profile information
• Query hf hub — Ask a natural language question about the Hugging Face Hub and get an AI-generated answer
• Fetch hf doc — Fetch the content of a Hugging Face documentation page by URL, with optional character offset for pagination
• Generate gr1 z image turbo — Generate an image from a text prompt using the Image Turbo model hosted on Hugging Face Spaces

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

huggingfacemcp_dynamic_space#Call a Hugging Face MCP-enabled Space dynamically. Use 'discover' to list available MCP spaces, 'view_parameters' to inspect a space's tools, or 'invoke' to call a specific tool.3 params▾

Call a Hugging Face MCP-enabled Space dynamically. Use 'discover' to list available MCP spaces, 'view_parameters' to inspect a space's tools, or 'invoke' to call a specific tool.

NameTypeRequiredDescription

operationstringoptionalAction to perform: discover lists available tasks, view_parameters inspects a space, invoke runs it.

parametersstringoptionalJSON string of input parameters. Used only with the "invoke" operation.

space_namestringoptionalSpace ID in "username/space-name" format. Required for "view_parameters" and "invoke" operations.

huggingfacemcp_gr1_z_image_turbo_generate#Generate an image from a text prompt using the Image Turbo model hosted on Hugging Face Spaces.6 params▾

Generate an image from a text prompt using the Image Turbo model hosted on Hugging Face Spaces.

NameTypeRequiredDescription

promptstringoptionalText prompt describing the desired image content

random_seedbooleanoptionalGenerate a new random seed for each run. Set to false to use the value in the seed field.

resolutionstringoptionalOutput resolution in "WIDTHxHEIGHT ( RATIO )" format.

seedintegeroptionalSeed value for reproducible image generation. Ignored when random_seed is true.

shiftnumberoptionalTime shift parameter for the flow matching scheduler. Controls generation quality.

stepsnumberoptionalNumber of inference steps for the diffusion process. Higher values improve quality but take longer.

huggingfacemcp_hf_doc_fetch#Fetch the content of a Hugging Face documentation page by URL, with optional character offset for pagination.2 params▾

Fetch the content of a Hugging Face documentation page by URL, with optional character offset for pagination.

NameTypeRequiredDescription

doc_urlstringrequiredFull URL of the Hugging Face or Gradio documentation page to fetch.

offsetnumberoptionalToken offset for paginating large documents. Use the offset value from the truncation message to fetch the next chunk.

huggingfacemcp_hf_doc_search#Search Hugging Face documentation across all products or a specific product by query.2 params▾

Search Hugging Face documentation across all products or a specific product by query.

NameTypeRequiredDescription

querystringrequiredSemantic search query. Use an empty string to explore structure and navigation tips, or provide a specific query to find targeted documentation.

productstringoptionalHugging Face product or library to filter results by. Provide when known to narrow the search.

huggingfacemcp_hf_hub_query#Ask a natural language question about the Hugging Face Hub and get an AI-generated answer.1 param▾

Ask a natural language question about the Hugging Face Hub and get an AI-generated answer.

NameTypeRequiredDescription

messagestringrequiredNatural language query to run against the Hugging Face Hub.

huggingfacemcp_hf_whoami#Return the currently authenticated Hugging Face user's profile information.0 params▾

Return the currently authenticated Hugging Face user's profile information.

huggingfacemcp_hub_repo_details#Retrieve details for one or more Hugging Face Hub repositories by their IDs.7 params▾

Retrieve details for one or more Hugging Face Hub repositories by their IDs.

NameTypeRequiredDescription

repo_idsarrayrequiredOne or more repository IDs in "author/name" format. Supports models, datasets, and spaces.

configstringoptionalDataset Viewer config name. Required for dataset_preview when the dataset has multiple configs. Discover available configs via dataset_structure.

limitintegeroptionalNumber of rows to return for dataset_preview. Defaults to 5; clamped between 1 and 100.

offsetintegeroptionalRow offset for dataset_preview pagination. Defaults to 0.

operationsarrayoptionalDetails to return. Defaults to ["overview"]. For datasets, use ["overview", "dataset_structure"] first, then ["dataset_preview"] with config and split.

repo_typestringoptionalRepository type to look up. Auto-detected when omitted.

splitstringoptionalDataset split name. Required for dataset_preview when the dataset has multiple splits. Discover available splits via dataset_structure.

huggingfacemcp_hub_repo_search#Search the Hugging Face Hub for models, datasets, or spaces with optional filters for author, task, and sort order.6 params▾

Search the Hugging Face Hub for models, datasets, or spaces with optional filters for author, task, and sort order.

NameTypeRequiredDescription

authorstringoptionalOrganization or user namespace to filter results by.

filtersarrayoptionalHub filter tags to apply to each selected repo type. Supports task tags, language codes, and framework tags.

limitnumberoptionalMaximum number of results to return per selected repository type. Clamped between 1 and 100.

querystringoptionalSearch term for repositories. Leave blank with sort + limit set to browse trending or recent repos.

repo_typesarrayoptionalRepository types to include in the search. Defaults to model and dataset. space uses keyword search.

sortstringoptionalSort order for results, applied in descending order.

huggingfacemcp_paper_search#Search Hugging Face Papers by query and return matching papers with abstracts and author information.3 params▾

Search Hugging Face Papers by query and return matching papers with abstracts and author information.

NameTypeRequiredDescription

querystringrequiredSemantic search query for finding ML research papers.

concise_onlybooleanoptionalReturn a 2-sentence abstract summary instead of the full text. Recommended for broad queries that return many results.

results_limitnumberoptionalMaximum number of paper results to return.

huggingfacemcp_space_search#Search Hugging Face Spaces by query and return matching spaces with relevance scores.3 params▾

Search Hugging Face Spaces by query and return matching spaces with relevance scores.

NameTypeRequiredDescription

querystringrequiredSemantic search query for finding Hugging Face Spaces.

limitnumberoptionalMaximum number of Space results to return.

mcpbooleanoptionalSet to true to return only MCP Server-enabled Spaces. Required when using results with dynamic_space.