smolagents

Hugging Face smolagents connects to SAN with a ToolCollection, which pulls SAN’s MCP tools into a CodeAgent or ToolCallingAgent.

Prerequisites

Python 3.10+
A SAN API key
Create one in the API Quickstart if you don’t have one yet.

Quick Start

Install smolagents with the MCP extra

pip install "smolagents[mcp]"

Describe SAN's MCP server

Set the transport to streamable-http and pass your key in headers.

server = {
    "url": "https://playground.sanfoundation.com/mcp",
    "transport": "streamable-http",
    "headers": {"x-api-key": "sk_..."},
}

Run an agent with SAN's tools

ToolCollection.from_mcp requires trust_remote_code=True. Open it as a context manager so the connection is closed for you.

from smolagents import ToolCollection, CodeAgent, InferenceClientModel

model = InferenceClientModel()

with ToolCollection.from_mcp(server, trust_remote_code=True) as tool_collection:
    agent = CodeAgent(
        tools=[*tool_collection.tools],
        model=model,
        add_base_tools=True,
    )
    agent.run("List the available SAN agents.")

Getting started

Integrations

smolagents

Prerequisites

Quick Start

​Prerequisites

​Quick Start

Prerequisites

Quick Start