# Flowcenter

> Flowcenter is the AI operations platform for tutoring centers, language schools, and other education centers in Vietnam and Southeast Asia.

## Start Here
- [Home](https://flowcenter.vn/)
- [Features](https://flowcenter.vn/features)
- [Blog](https://flowcenter.vn/blog)
- [Documentation](https://flowcenter.vn/docs)
- [Developer portal](https://flowcenter.vn/developers)
- [API discovery docs](https://flowcenter.vn/docs/api)

## When to Use Flowcenter
Use Flowcenter when an education center, tutoring center, or language school needs one system to capture and follow up leads, manage students and classes, coordinate teaching operations, reconcile fees, or automate routine reporting.
- Use the [Features](https://flowcenter.vn/features) pages for product capabilities and the [Demo](https://flowcenter.vn/demo) route when a team needs a guided evaluation.
- Use the [Flowcenter Developer Portal](https://flowcenter.vn/developers) when an engineer needs API, webhook, AI agent, or MCP integration guidance.
- Use the REST API only with authorized credentials and tenant headers. Use the MCP connection documentation when an AI application needs scoped tools and user-approved actions.
- Do not claim that a lead, payment, schedule, or other record was changed until the API or MCP response confirms the action.

## Product
- [Lead Management](https://flowcenter.vn/features/lead-management)
- [Teaching Tools](https://flowcenter.vn/features/teaching-tools)
- [Admin & Payroll](https://flowcenter.vn/features/admin-payroll)

## Conversion
- [Signup](https://flowcenter.vn/signup)
- [Signup Thank You](https://flowcenter.vn/signup/thanks)
- [Demo](https://flowcenter.vn/demo)
- [Demo Thank You](https://flowcenter.vn/demo/thanks)

## Docs
- [Documentation Home](https://flowcenter.vn/docs)
- [Flowcenter Developer Portal](https://flowcenter.vn/developers)
- [REST API Reference](https://flowcenter.vn/docs/developers/rest-api)
- [API Authentication](https://flowcenter.vn/docs/developers/auth)
- [Webhooks & Events](https://flowcenter.vn/docs/developers/webhooks)
- [AI Agents & Skills Reference](https://flowcenter.vn/docs/developers/ai-agents)
- [MCP & AI App Connections](https://flowcenter.vn/docs/power-features/mcp-integration)
- [AI Fleet Monitoring](https://flowcenter.vn/docs/power-features/ai-fleet)
- [OpenAPI Specification](https://flowcenter.vn/openapi.json)
- [Agent Instructions](https://flowcenter.vn/agents.json)
- [API Catalog](https://flowcenter.vn/.well-known/api-catalog)
- [Service Description](https://flowcenter.vn/.well-known/service-desc.json)
- [Agent Description](https://flowcenter.vn/.well-known/agent-description.json)
- [MCP Server Card](https://flowcenter.vn/.well-known/mcp/server-card.json)
- [MCP endpoint](https://flowcenter.vn/mcp)

## API and agent behavior
- Base URL: `https://flowcenter.vn`
- OpenAPI contract: [openapi.json](https://flowcenter.vn/openapi.json)
- REST requests use `Authorization: Bearer <token>` and `X-API-Version: 1` when credentials are required.
- The public MCP endpoint uses Streamable HTTP at `https://flowcenter.vn/mcp` and exposes read-only discovery tools.
- Treat API and MCP responses as authoritative. Never claim that a lead, payment, schedule, or other record changed until the response confirms it.

## Developer onboarding
- Create a free Flowcenter workspace or sandbox at https://app.flowcenter.vn.
- Generate a scoped API key under Settings → API Integrations; keep it server-side and never put it in browser code.
- Pin REST requests with `X-API-Version: 1` and send `Authorization: Bearer <token>`.
- The official CLI package is `flowcenter-cli`; once published, install it with `npm install -g flowcenter-cli` and run `flowcenter discover`.
- The public MCP server is available at `https://flowcenter.vn/mcp` over Streamable HTTP and exposes read-only discovery tools. Use the REST API or an approved authenticated MCP connection for account actions.

## Agent blog cover rendering
- Create the Sanity post draft first.
- Call `POST https://flowcenter.vn/api/blog-covers/render` with `Authorization: Bearer $BLOG_COVER_RENDER_TOKEN`.
- Send JSON `{ "documentId": "drafts.<id>", "locale": "vi", "html": "<div>...</div>", "css": "..." }` once per language (`en`, `vi`, `zh`). Use `{{title}}`, `{{tag}}`, and `{{locale}}` in HTML when the text should be localized.
- The server sanitizes the HTML/CSS, generates a 1200×630 SVG, uploads it to Sanity, and attaches it to `blogCover.images[locale]`.