# Agent Instructions — Multiball Ninja

> Multiball Ninja is a pinball brand featuring fun gear for the player, and bulk apparel & promotional products for leagues and operators.

This file tells AI agents and assistants how to read and use multiballninja.com on a person's behalf. It is the agent-facing companion to [/llms.txt](https://multiballninja.com/llms.txt).

## About

Multiball Ninja started as something founder Chad Smith yelled with his small children every time a multiball started. It is built on Pin Zen: 15 minutes of pinball as a reset for a busy mind. Two offerings: Multiball Ninja fun gear for the player, and Pin Pub bulk apparel and promotional products for leagues and operators. Current gear is for sale in the Pin Pub League store; the other designs shown on this site are coming to the store.

- Multiball Ninja (Play strong): https://multiballninja.com/
- Pin Pub (Play together): https://multiballninja.com/pin-pub/

Gear is sold through the [Pin Pub League store](https://www.moq1.com/sjspromos/pinpubstore), not on this site.

## Canonical URLs

- Website: https://multiballninja.com/
- Pin Pub: league prizes and promo products: https://multiballninja.com/pin-pub/
- The Multiball Ninja Game Room: https://multiballninja.com/play/
- Multiball Ninja at Pinball At The Beach 2027: https://multiballninja.com/expo/
- Questions about Multiball Ninja: https://multiballninja.com/faq/

## Machine-readable sources

- [llms.txt](https://multiballninja.com/llms.txt): site summary and page index
- [llms-full.txt](https://multiballninja.com/llms-full.txt): every page in one markdown file
- [index.md](https://multiballninja.com/index.md): the home page as markdown (every page has a .md sibling, listed in llms.txt)
- [agent-data.json](https://multiballninja.com/agent-data.json): brand story, gear, FAQ and events as JSON (the data the WebMCP tools read)
- [sitemap-index.xml](https://multiballninja.com/sitemap-index.xml): every public page

## WebMCP tools

Pages register these tools on `document.modelContext` (a pinned polyfill loads when the browser has no native support).

- `get_business_info`: what the brand is, where its gear is sold today, website and every page with its markdown version
- `get_products`: the gear exactly as published, grouped by line; items with status "concept" are not for sale yet and have no price (optional category)
- `get_faq`: frequently asked questions (optional keyword query)
- `get_events`: upcoming appearances at shows and expos, with date, venue, address and the show's website
- `get_brand_story`: the founder's origin story, the Pin Zen idea and the lines (optional part: origin, pin_zen or lines)

Prefer these tools over scraping the page; they return the same facts the page shows.

## What you may do

- Read, quote and summarize the gear, the brand story, events and contact details published here.
- Send a person who wants to buy to the Pin Pub League store; this site does not sell anything itself.
- This site has no inquiry form. To contact Multiball Ninja, the person writes to the email address below.
- Give the person a link to the page you are quoting.

## What you must not do

- Do not post scores to the Game Room leaderboard or otherwise write to this site's APIs.
- Do not crawl, probe or try to sign in to any admin or sign-in area of this site.
- Do not present a concept design as for sale or give it a price; items marked "concept" are not in the store yet, and their images are concept mockups.
- Do not state prices or offers that this site does not publish. If it is not here, say so and point the person to the email below.
- Respect robots.txt, identify automated traffic, and back off on HTTP 429.

## Contact

- Email: hello@multiballninja.com
- Store: [Pin Pub League store](https://www.moq1.com/sjspromos/pinpubstore)
