README.md

metadata

title: hub-query-staging
emoji: 🔎
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
short_description: Staging fast-agent MCP server for HF Hub queries.
hf_oauth: true
hf_oauth_expiration_minutes: 480
hf_oauth_scopes:
  - inference-api

hub-query-staging

This staging Space runs a raw-passthrough fast-agent MCP server backed by the custom Monty build used for Hugging Face Hub querying.

The deployed card uses tool_result_mode: passthrough, so tool results are returned directly rather than rewritten by a second LLM pass.

Auth

This Space is configured for Hugging Face OAuth/token passthrough:

• FAST_AGENT_SERVE_OAUTH=huggingface
• FAST_AGENT_OAUTH_SCOPES=inference-api
• --instance-scope request

The README enables Space OAuth (hf_oauth: true) and the container sets the fast-agent OAuth environment. SPACE_HOST is used by fast-agent to derive the public OAuth resource URL. No shared HF_TOKEN is required for user-scoped OAuth/token pass-through.

Clients can either:

• send Authorization: Bearer <HF_TOKEN> directly, or
• use MCP OAuth discovery/auth flow

Model

The deployed card uses:

• hf.openai/gpt-oss-120b:sambanova

Main files

• hf-hub-query.md — raw MCP card
• tool_entrypoints.py / monty_api/ — Hub query tool implementation
• _monty_codegen_shared.md — shared codegen instructions
• wheels/fast_agent_mcp-0.8.0-py3-none-any.whl — staging fast-agent wheel from ../fast-agent-pr/

Dependencies

The Space installs the staged fast-agent-mcp wheel from this repo and pydantic-monty==0.0.17 from PyPI.