Skip to content
ARCHITECTURE / 03 — Composability

Composability

In addition to a web application that offers a good experience, T&T provides composability for worlds in the following ways.

  • Smart contracts
  • API

Smart Contracts

T&T provides smart contracts that comply with the ERC-721 non-fungible token (NFT) standard, so world operators and participants can access information on the blockchain at any time through the smart contracts. For programming convenience, we also provide a TypeScript library for ethers.js / TypeChain in the following repository.

TypeScript bindings of T&T’s Smart Contracts for ethers.js v6.

https://github.com/TalesAndTokens/ttt-ts-bindings ↗

For the structure of the smart contracts, see here.

API

T&T provides an API. Information such as check-in records and owned items that exist in a T&T world can be retrieved through this API. For the data available through the API, see Conceptual Model.

T&T’s API consists of the World Connect API, which is accessed from systems developed by world owners, and the App API, which players can access via OAuth 2.0. You can choose between them depending on your use case.

T&T MCP

T&T provides “T&T MCP,” which supports MCP (Model Context Protocol), a common standard for connecting AI with external services. By registering the T&T MCP endpoint and an API key (which can be issued for free from World Builder) with an MCP-compatible AI agent such as Claude Code, you can operate your world through chat instructions.

For example, you can register and edit the answer choices and correct/incorrect answers, rewards, images, and so on for a puzzle hunt event all at once, without any programming. For first-timers, we have also published the step-by-step “T&T Nazotoki Kit,” bundled with the World Builder plugin for Claude Code.

For setup instructions, see the help page “Operating World Builder from an AI agent” (in Japanese).

https://help.ttt.place/builder/ai-agent/ ↗

https://github.com/TalesAndTokens/world-builder-agent-playbook ↗

Principles

The world information recorded in T&T is important and valuable to both users and operators. By valuing composability, T&T enables users and operators to make the most of the information recorded in T&T.