Troubleshooting

zsh: no matches found: .[dev,deep]

Quote extras:

pip install -e ".[dev,deep]"

Create/activate a venv:

python3 -m venv .venv && source .venv/bin/activate

Ensure your server exposes a path (e.g., /mcp) and your client uses it:

HTTPServerSpec(url="http://127.0.0.1:8000/mcp", transport="http")

Use the version where _client and _tool_name are PrivateAttr and set in __init__. Update your package.

Tool-calling models add overhead. Use smaller models while developing.

config_schema warnings are safe. We’ll migrate to context_schema when stable.