Virtuals GAME SDK (Python)

pip install game-plugin-oneshot

import os
from game_sdk.game.agent import Agent
from game_plugin_oneshot import OneShotPlugin

plugin = OneShotPlugin(
    private_key=os.environ["WALLET_PRIVATE_KEY"],
)

# Create a GAME agent
agent = Agent(
    api_key=os.environ["GAME_API_KEY"],
    name="my-agent",
    agent_description="An agent that can interact with the real world",
)

# Add OneShot tools as a worker
agent.add_worker(plugin.get_worker())
agent.run()

# The GAME agent will generate these automatically,
# but for manual testing:
import json

shipping = json.dumps({
    "first_name": "John",
    "last_name": "Doe",
    "street": "123 Main St",
    "city": "Austin",
    "state": "TX",
    "zip_code": "78701",
    "phone": "+15551234567",
})

product = json.dumps({
    "name": "Acme SaaS",
    "description": "Project management for teams",
})

plugin = OneShotPlugin(private_key="0x...")

# Custom API URL
plugin = OneShotPlugin(private_key="0x...", base_url="https://custom-api.example.com")

# Credits-only session for runners that must not hold a wallet key (see Remote MCP):
plugin = OneShotPlugin(access_token="oneshot_...")
# Inside a running event loop use the async factory instead:
plugin = await OneShotPlugin.acreate(access_token="oneshot_...")

# Required
WALLET_PRIVATE_KEY=0x...    # Ethereum private key for x402 payments
GAME_API_KEY=...            # Virtuals GAME API key

# Optional
ONESHOT_BASE_URL=...        # Override API endpoint