tf-sync

ToothFairyAI workspace sync layer for tfcode.

Purpose

This Python module syncs tools from a ToothFairyAI workspace to tfcode:

MCP Servers - Tools with isMCPServer=true
Agent Skills - Tools with isAgentSkill=true
Database Scripts - Tools with isDatabaseScript=true
API Functions - Tools with requestType set

Installation

pip install tf-sync

Usage

from tf_sync import (
    load_config,
    validate_credentials,
    sync_tools,
    sync_mcp_servers,
    ToolType,
)

# Load configuration from environment (TF_WORKSPACE_ID, TF_API_KEY, TF_REGION)
config = load_config()

# Validate credentials
result = validate_credentials(config)
if result.success:
    print(f"Connected to workspace: {result.workspace_name}")

# Sync all tools (API Functions)
result = sync_tools(config)
for tool in result.tools:
    print(f"- {tool.name} ({tool.tool_type.value})")

Configuration

Set these environment variables:

TF_WORKSPACE_ID - Your ToothFairyAI workspace UUID
TF_API_KEY - Your ToothFairyAI API key
TF_REGION - Region: dev, au (default), eu, or us

Region URLs

Region	Base URL	Use Case
`dev`	api.toothfairylab.link	Development/Testing
`au`	api.toothfairyai.com	Australia (Default)
`eu`	api.eu.toothfairyai.com	Europe
`us`	api.us.toothfairyai.com	United States

Dependencies

toothfairyai - Official ToothFairyAI Python SDK
pydantic - Data validation
httpx - HTTP client
rich - Console output

License

MIT