Hugging Face Hub
live AI/MLResearchLargest open ML hub — search and inspect models, datasets, Spaces. Public reads keyless.
10 tools
0ms auth
free tier 50 calls/day
Tools
search_models Browse / search models.
Parameters
Name Type Description
search opt string — author opt string — library opt string — language opt string — pipeline_tag opt string — tags opt string — sort opt string — direction opt string — limit opt number — full opt boolean — Try it
Response
search_datasets Browse / search datasets.
Parameters
Name Type Description
search opt string — author opt string — language opt string — task_categories opt string — sort opt string — direction opt string — limit opt number — full opt boolean — Try it
Response
search_spaces Browse / search Spaces.
Parameters
Name Type Description
search opt string — author opt string — sdk opt string — sort opt string — direction opt string — limit opt number — full opt boolean — Try it
Response
get_model
required: repo_id Detailed model info.
Parameters
Name Type Description
repo_id req string — revision opt string — Try it
Response
get_dataset
required: repo_id Detailed dataset info.
Parameters
Name Type Description
repo_id req string — revision opt string — Try it
Response
get_space
required: repo_id Detailed Space info.
Parameters
Name Type Description
repo_id req string — revision opt string — Try it
Response
list_model_files
required: repo_id List files in a model repo.
Parameters
Name Type Description
repo_id req string — revision opt string — path opt string — Try it
Response
list_dataset_files
required: repo_id List files in a dataset repo.
Parameters
Name Type Description
repo_id req string — revision opt string — path opt string — Try it
Response
trending_models Currently-trending models.
Parameters
Name Type Description
limit opt number — Try it
Response
trending_datasets Currently-trending datasets.
Parameters
Name Type Description
limit opt number — Try it
Response
Test with curl
The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.
List available tools
bash
curl -X POST https://gateway.pipeworx.io/huggingface/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Call a tool
bash
curl -X POST https://gateway.pipeworx.io/huggingface/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_models","arguments":{}}}'Use with the SDK
Install @pipeworx/sdk to call tools from any TypeScript/Node project.
TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search_models", {}); ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("largest open ml hub — search and inspect models, datasets, spaces");