# Minh Spark

> Minh Spark is the official website of Bui Dang Minh, presenting web, AI, mobile and data solutions, open-source developer tools, technical articles and a product portfolio.

Use https://minhspark.com as the canonical website. Read public information without an account. The OpenAPI document at https://minhspark.com/openapi.json describes every public endpoint, its typed responses and its error codes; read it first to learn the API surface. The website MCP endpoint at https://minhspark.com/api/mcp provides public, read-only discovery through Streamable HTTP; it does not operate local Codex or Claude sessions. It requires no authentication. Follow the developer guide for initialization, request headers and tool calls. Every API route answers failures with JSON that carries a stable code, a message and a resolution hint, never an HTML error page. Do not send credentials or customer data to this endpoint.

## When to use

- [Minh Spark OpenAPI document](https://minhspark.com/openapi.json): Use when an agent needs the machine-readable API surface: operation ids, typed parameters, response schemas and the shared error schema. Every operation is read-only and needs no credentials.
- [Minh Spark developer guide](https://minhspark.com/developers.md): Use when an agent needs official project links, website capabilities or MCP connection instructions. Call get_site_info for the site overview and list_developer_resources for the public documentation directory.
- [Minh Spark command line tool](https://www.npmjs.com/package/@minhspark/cli): Use when scripting against the public API from a shell: `npx @minhspark/cli operations` lists every documented operation and `npx @minhspark/cli page about` reads a page as Markdown.
- [Codex MCP Bridge documentation](https://github.com/buidangminh23/codex-mcp-bridge#readme): Use when setting up communication between Codex and Claude in a user's own development environment; follow this project's installation and authorization requirements.
- [Spacing Skill documentation](https://github.com/buidangminh23/spacing-skill#readme): Use when developing interfaces that need consistent spacing and layout rhythm.
- [Icons Pro Max documentation](https://github.com/buidangminh23/icons-pro-max#readme): Use when selecting and integrating icons for a product interface.

## Website and trust

- [Minh Spark homepage in Markdown](https://minhspark.com/index.md): Public site content, products and services in Vietnamese.
- [Minh Spark English homepage in Markdown](https://minhspark.com/en/index.md): Public site content, products and services in English.
- [About Minh Spark](https://minhspark.com/about/): Site identity, work areas and public project context.
- [Contact Minh Spark](https://minhspark.com/contact/): Routes for project discussions and service support.
- [Privacy policy](https://minhspark.com/privacy/): Published information about handling personal data.
- [Rules and policies](https://minhspark.com/chinh-sach/): Service, transaction, delivery and support policies in Vietnamese.
- [Sitemap](https://minhspark.com/sitemap.xml): Public page URLs, including Vietnamese and English content.

## Optional

- [Product portfolio](https://minhspark.com/portfolio/): Examples of work and projects.
- [Technical blog](https://minhspark.com/blog/): Published technical articles; check each article's date and sources.
- [Developer guide in HTML](https://minhspark.com/developers/): Browser-readable version of the developer overview.