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 35 OneShot tools (same set as the MCP server and langchain-oneshot):

Tool	Description	Paid?
`oneshot_email`	Send emails to real recipients	paid
`oneshot_sms`	Send SMS text messages	paid
`oneshot_voice`	Make phone calls with an AI voice agent	paid
`oneshot_research`	Deep research reports	paid
`oneshot_web_search`	Web search (fast, synchronous)	paid
`oneshot_web_read`	Read a web page as markdown	paid
`oneshot_people_search`	Search people by title/company/location	paid
`oneshot_enrich_profile`	Enrich a profile from LinkedIn/email/name	paid
`oneshot_find_email`	Find an email at a company	paid
`oneshot_verify_email`	Verify email deliverability	paid
`oneshot_deep_research_person`	Full background report on a person	paid
`oneshot_social_profiles`	Find someone's social accounts	paid
`oneshot_article_search`	Articles/interviews about a person	paid
`oneshot_person_newsfeed`	Recent social posts for a person	paid
`oneshot_person_interests`	What a person cares about	paid
`oneshot_person_interactions`	Followers/following/replies	paid
`oneshot_commerce_search`	Search for products	free
`oneshot_commerce_buy`	Purchase products online	paid
`oneshot_build`	Generate and deploy a website	paid
`oneshot_update_build`	Update an existing website	paid
`oneshot_browser`	Browser automation task	paid
`oneshot_browser_create_profile`	Create a persistent browser profile	free
`oneshot_browser_list_profiles`	List browser profiles	free
`oneshot_browser_delete_profile`	Delete a browser profile	free
`oneshot_inbox_list`	List inbound emails	free
`oneshot_inbox_get`	Get an inbound email by ID	free
`oneshot_sms_inbox_list`	List inbound SMS	free
`oneshot_sms_inbox_get`	Get an inbound SMS by ID	free
`oneshot_notifications`	List agent notifications	free
`oneshot_mark_notification_read`	Mark a notification as read	free
`oneshot_get_balance`	Get USDC + credits balance	free
`oneshot_budget_status`	Today's spend vs the configured budget (read-only)	free
`oneshot_list_domains`	List sending domains with reputation + rotation state	free
`oneshot_pause_domain`	Take a domain out of rotation	free
`oneshot_resume_domain`	Put a paused domain back into rotation	free

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.

Read tools (inbox, SMS inbox, notifications, balance) send a signed EIP-712 read proof (x-agent-proof) so the API can verify you control the X-Agent-ID wallet before returning private data. Handled automatically by the underlying oneshot-python client — requires oneshot-python >= 0.18.0 (already the dependency floor).

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

Parameter	Default	Description
`private_key`	(required)	Hex-encoded Ethereum private key
`base_url`	`None`	Override API URL
`budgets`	`None`	Server-enforced spend cap, e.g. `{"daily": 50, "per_transaction": 5}`
`alert_email`	`None`	Email for budget alerts

Requirements

Python >= 3.10
game-sdk >= 0.1.5
oneshot-python >= 0.18.0

License

MIT

Metadata

Release files for game-plugin-oneshot 0.12.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for game-plugin-oneshot 0.12.0
File	Size	Uploaded
game_plugin_oneshot-0.12.0.tar.gz	92.6 kB	Sep 2, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for game-plugin-oneshot 0.12.0
File	Interpreter	ABI	Platform	Reset
game_plugin_oneshot-0.12.0-py3-none-any.whl 13.6 kB Sep 2, 2026	Python 3	none	any	Details

Total release size: 106.2 kB

Release files / game_plugin_oneshot-0.12.0.tar.gz

Download URL	game_plugin_oneshot-0.12.0.tar.gz
Size	92.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`a10430a72e44f67b30ed3c0572b8e9fb55b29f728c361106105d76c2a9bab1ca`
BLAKE2b-256 checksum How to use checksums	`7026a31acbc2840c38e6648fdd5dce92b9e0616ebd1db9068fa5c467ded909a5`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.10.19`

Release files / game_plugin_oneshot-0.12.0-py3-none-any.whl

Download URL	game_plugin_oneshot-0.12.0-py3-none-any.whl
Size	13.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`70c526301b67ab9e606d1743f89760ce03c41d5af30b35f96ecb43ac96893578`
BLAKE2b-256 checksum How to use checksums	`eb7ce3da5d941fb6459d4f93c905dade980d3e78757e2298fc902d4add7078fb`
Upload date	Sep 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.10.19`