> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spojit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect the Hugging Face MCP server

> Connect the Hugging Face MCP server to Spojit to search models, datasets, Spaces, and papers, and run community Gradio tools from your workflows.

The **Hugging Face MCP Server** connects AI agents to the Hugging Face Hub: search models, datasets, Spaces, and papers, search the documentation, run Jobs, and call community tools from MCP-compatible Gradio Spaces. Connect it to Spojit to research models inside a workflow or run a Space as a step.

<Note>
  Spojit connects to this server through a [custom MCP server](/connectors/remote-mcp-servers/custom) connection, so you add it with **Add custom server** rather than from the connector catalog. Hugging Face maintains it and decides which tools it offers; see [Hugging Face's MCP Server documentation](https://huggingface.co/docs/hub/en/agents-mcp) for the current list.
</Note>

## Before you start

* A Hugging Face account. Choose the extra tools and Spaces you want in your [MCP settings](https://huggingface.co/settings/mcp); the connection picks up what you enable there.

## Server URL

```
https://huggingface.co/mcp
```

## Connect in Spojit

<Steps>
  <Step title="Add a custom server">
    Go to **Connections** and click **Add custom server**. Enter a **Name** such as `Hugging Face` and paste the **Server URL**.
  </Step>

  <Step title="Keep Auto authentication">
    Leave **Authentication** on **Auto**, choose a visibility, and click **Save & connect**.
  </Step>

  <Step title="Approve access in Hugging Face">
    Hugging Face opens its authorization page. Sign in and approve. Spojit marks the connection **Connected** and refreshes the token automatically.
  </Step>
</Steps>

## Use it in a workflow

Add a **Connector** node, pick your Hugging Face server under **Custom Servers**, and choose **Agent Mode** or **Direct Mode**. See [Use a custom server in a workflow](/connectors/remote-mcp-servers/custom#use-a-custom-server-in-a-workflow).

## Troubleshooting

<AccordionGroup>
  <Accordion title="A Space or tool is missing">
    Add it in your [MCP settings](https://huggingface.co/settings/mcp), then re-save the connection in Spojit to refresh the tool list.
  </Accordion>
</AccordionGroup>

## Learn more

* [Hugging Face MCP Server](https://huggingface.co/docs/hub/en/agents-mcp)
* [Spaces as MCP servers](https://huggingface.co/docs/hub/spaces-mcp-servers)

<Snippet file="start-free.mdx" />