๐ The fast, Pythonic way to build MCP servers and clients.
Namespace Activation
Demonstrates session-specific visibility control using tags to organize tools into namespaces that can be activated on demand.
Pattern
- Tag tools with namespaces:
@server.tool(tags={"namespace:finance"}) - Globally disable namespaces:
server.disable(tags={"namespace:finance"}) - Provide activation tools that call
ctx.enable_components(tags={"namespace:finance"})
Each session starts with only the activation tools visible. When a session calls an activation tool, that namespace becomes visible only for that session.
Run
# Server
uv run python server.py
# Client (in another terminal)
uv run python client.py
Example Output
Namespace Activation Demo
โญโโโโโโโโโโโโโโโโโโโ Initial Tools โโโโโโโโโโโโโโโโโโโโฎ
โ activate_finance, activate_admin, deactivate_all โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ Calling activate_finance()
Finance tools activated
โญโโโโโโโโโโโโโโโ After Activating Finance โโโโโโโโโโโโโฎ
โ analyze_portfolio, get_market_data, execute_trade, โ
โ activate_finance, activate_admin, deactivate_all โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ Calling get_market_data(symbol='AAPL')
{'symbol': 'AAPL', 'price': 150.25, 'change': '+2.5%'}
โ Calling activate_admin()
Admin tools activated
โญโโโโโโโโโโโโโโ After Activating Admin โโโโโโโโโโโโโโโโฎ
โ analyze_portfolio, get_market_data, execute_trade, โ
โ list_users, reset_user_password, activate_finance, โ
โ activate_admin, deactivate_all โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ Calling deactivate_all()
All namespaces deactivated
โญโโโโโโโโโโโโโโ After Deactivating All โโโโโโโโโโโโโโโโฎ
โ activate_finance, activate_admin, deactivate_all โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ