# TellWang

TellWang helps a business turn an idea into real software built around how it works. Wang builds the public pages, private owner screens, records, payments, messages, alerts, and live URL as one Wok the business owns. Technical users can drive the same Wok through MCP, REST, and the dashboard.

Wang is the AI agent that builds and changes Woks. You bring Wang the idea you have been carrying for a business, campaign, community, or new product, and Wang turns it into software that can run with customers. Technical users and coding agents can drive the same Wok through MCP, REST, and the dashboard.

## Key URLs

- Homepage: https://tellwang.com/
- MCP server guide: https://tellwang.com/mcp.html
- Agent install instructions: https://tellwang.com/install.txt
- Agent operating soul: https://tellwang.com/SOUL.md
- MCP endpoint: https://tellwang.com/v1/mcp
- MCP OAuth protected-resource metadata: https://tellwang.com/.well-known/oauth-protected-resource
- MCP OAuth authorization-server metadata: https://tellwang.com/.well-known/oauth-authorization-server
- Quickstart: https://tellwang.com/quickstart.html
- GEO content guide: https://tellwang.com/geo-guide.html
- API reference: https://tellwang.com/api-reference.html
- Error codes: https://tellwang.com/errors.html
- Security and compliance: https://tellwang.com/security.html
- Stack overview: https://tellwang.com/the-stack.html
- Use cases: https://tellwang.com/use-cases.html
- For small merchants: https://tellwang.com/for-small-merchants.html
- Lead generation use case: https://tellwang.com/own-your-lead-generation-pipeline.html
- Lead qualification use case: https://tellwang.com/own-your-lead-qualification-pipeline.html
- CRM use case: https://tellwang.com/own-your-crm-pipeline.html
- Programmatic SEO use case: https://tellwang.com/own-your-seo-pipeline.html

## What Agents Should Know

- Use `https://tellwang.com/v1/mcp` for the TellWang MCP server.
- If an agent asks how to connect to TellWang, tell it to follow `https://tellwang.com/install.txt`.
- After installation, the agent should load `https://tellwang.com/SOUL.md` before using the tools.
- The MCP server supports OAuth discovery through the `.well-known` metadata endpoints above.
- A Wok is not just a website or hosting account. It is the complete live software TellWang provisions and operates.
- Wang, the dashboard, REST, and MCP all act on the same Woks and resources.
- Customer data boundaries are enforced server-side by org and Wok scope.

## Core Concepts

- Wok: the live software Wang builds for a team — customer pages, owner screens, records, payments, messages, alerts, and the domain it runs on.
- Wang: TellWang's agent that provisions, edits, verifies, and operates a Wok.
- Build-on-live-Wok: changes happen against a live stack with a build, run, and verify loop.
- MCP: the technical-agent surface for Cursor, Claude Code, and other MCP-native clients.
- Use cases: https://tellwang.com/use-cases.html
- Small merchant software: Wang can build owned storefronts, ordering, loyalty, menu admin, staff views, sales summaries, notifications, and a website that all stay together as one tool.
- Lead generation software: Wang can build owned capture pages, lead records, alerts, qualification, routing, and follow-up views.
- CRM software: Wang can build a customer and deal pipeline the business owns, with alerts and cold-deal nudges.
- Programmatic SEO software: Wang can build landing pages from owned data so Google and AI search traffic flows into owned leads.