game-plugin-oneshot

GAME SDK plugin that gives Virtuals Protocol agents access to OneShot real-world tools.

Install

pip install game-plugin-oneshot

Quick Start

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

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

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

agent.add_worker(plugin.get_worker())
agent.run()

Tools

All 31 OneShot tools (same set as the MCP server and langchain-oneshot):

Paid tools are priced in USDC via x402. See Pricing for current rates.

Payment

All paid tools use the x402 payment protocol to deduct USDC from your wallet on Base Mainnet. Fund your wallet with USDC before using paid tools.

Complex Arguments

GAME Argument only supports scalar types. For tools that need structured input (commerce_buy, build, update_build), pass JSON strings; list fields on people_search accept comma-separated values:

# The 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",
})

Configuration

Requirements

• Python >= 3.10
• game-sdk >= 0.1.5
• oneshot-python >= 0.11.0

Links

• Documentation
• langchain-oneshot on PyPI — Full 31-tool LangChain integration
• oneshot-python on PyPI — Core HTTP client
• TypeScript SDK
• MCP Server
• GitHub

License

MIT