Hub documentation
Spaces as MCP servers
Spaces as MCP servers
You can expose any public Space that has a visible MCP
badge into a callable tool that will be available in any MCP-compatible client, you can add as many Spaces as you want and without writing a single line of code.
Setup your MCP Client
From your Hub MCP settings, select your MCP client (VSCode, Cursor, Claude Code, etc.) then follow the setup instructions.
Add an existing Space to your MCP tools
- Browse compatible Spaces to find Spaces that are usable via MCP. You can also look for the grey MCP badge on any Spaces card.
- Click the badge and choose Add to MCP tools then confirm when asked.
- The Space should be listed in your MCP Server settings in the Spaces Tools section.
Use Spaces from your MCP client
If your MCP client is configured correctly, the Spaces you added will be available instantly without changing anything (if it doesn’t restart your client and it should appear). Most MCP clients will list what tools are currently loaded so you can make sure the Space is available.
Build your own MCP-compatible Gradio Space
To create your own MCP-enabled Space, you need to Create a new Gradio Space then make sure to enable MCP support in the code. Get started with Gradio Spaces and make sure to check the detailed MCP guide for more details.
First, install Gradio with MCP support:
pip install "gradio[mcp]"
Then create your app with clear type hints and docstrings:
import gradio as gr
def letter_counter(word: str, letter: str) -> int:
"""Count occurrences of a letter in a word.
Args:
word: The word to search in
letter: The letter to count
Returns:
Number of times the letter appears in the word
"""
return word.lower().count(letter.lower())
demo = gr.Interface(fn=letter_counter,
inputs=["text", "text"],
outputs="number")
demo.launch(mcp_server=True) # exposes an MCP schema automatically
Push the app to a Gradio Space and it will automatically receive the MCP badge. Anyone can then add it as a tool with a single click.
mcp_server=True
parameter to your launch()
method, and ensure your functions have clear type hints and docstrings - you can use AI tools to automate this quite easily (example of AI generated docstrings).Be creative by mixing Spaces!
As Hugging Face Spaces is the largest directory of AI apps, you can find many creative tools that can be used as MCP tools. Mixing and matching different Spaces can lead to powerful and creative workflows.