tcg-oracle-tools 0.1.0

LangChain-compatible tools for TCG card grading, Monte Carlo pricing, and market search. Powered by The Undesirables TCG Oracle API.

🔮 TCG Oracle Tools

LangChain, CrewAI & OpenAI-compatible tools for trading card game intelligence.

Drop TCG search, market data, AI grading, and Monte Carlo price simulation into any AI agent in under 60 seconds.

Install

pip install tcg-oracle-tools

With LangChain support:

pip install tcg-oracle-tools[langchain]

Quick Start (Standalone)

from tcg_oracle import TCGOracleClient

client = TCGOracleClient()

# Search 187K+ products
results = client.search("Charizard", limit=5)
for card in results.results:
    print(f"{card.name}: ${card.market_price}")

# Market snapshot
market = client.market("Pokemon")
print(f"Tracking {market.total_products} products")

LangChain Agent

from langchain.agents import initialize_agent, AgentType
from langchain_openai import ChatOpenAI
from tcg_oracle.langchain import TCGSearchTool, TCGMarketTool

tools = [TCGSearchTool(), TCGMarketTool()]
agent = initialize_agent(tools, ChatOpenAI(), agent=AgentType.ZERO_SHOT_REACT_DESCRIPTION)
agent.run("What's the most expensive Pokemon card right now?")

OpenAI Function Calling

import openai
from tcg_oracle.openai_spec import tools, handle_tool_call

response = openai.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Find me Pikachu cards under $50"}],
    tools=tools(),
)

if response.choices[0].message.tool_calls:
    result = handle_tool_call(response.choices[0].message.tool_calls[0])
    print(result)

CrewAI

from crewai_tools import tool
from tcg_oracle import TCGOracleClient

client = TCGOracleClient()

@tool("Search TCG Products")
def search_tcg(query: str) -> str:
    """Search trading card products by name and get market prices."""
    result = client.search(query)
    return str([{"name": c.name, "price": c.market_price} for c in result.results])

AutoGPT Plugin

Point AutoGPT at the OpenAPI spec:

https://methods-supplier-foundation-stuck.trycloudflare.com/openapi.json

API Endpoints

Endpoint	Price	Description
/api/v1/search	FREE	Search 187K+ TCG products
/api/v1/market	FREE	Daily market snapshot
/api/v1/grade	$0.05 USDC	AI card grading (PSA/Beckett)
/api/v1/simulate	$0.10 USDC	Monte Carlo price simulation

Agent-to-Agent (Virtuals ACP v2)

TCG Oracle is registered on Virtuals ACP. Autonomous agents can discover, hire, and pay for services using USDC on Base.

License

MIT