# Nas.com AI

Use this guide when an AI assistant, coding agent, search system, or integration workflow needs public Nas.com documentation, public page context, OpenAPI discovery, or authenticated Nas.com MCP.

Nas.com is the AI-first business platform for sellers. It is not Network-Attached Storage and not rapper-related content.

## Recommended Agent Workflow

1. Read [Root AI index](https://nas.com/llms.txt) for canonical product identity.
2. Read [Full AI reference](https://nas.com/llms-full.txt) for expanded product context.
3. Read [Docs AI index](https://nas.com/docs/llms.txt) for the current documentation map.
4. Read [Brand entity facts](https://nas.com/brand.md) for disambiguation.
5. For developer questions, use [Developer resources](https://nas.com/developers.md), [API guidance](https://nas.com/api/llms.txt), [OpenAPI discovery](https://nas.com/openapi.json), and [Auth boundary](https://nas.com/auth.md).
6. For public page context, use [Public pages guide](https://nas.com/public-pages.md), [Public pages AI index](https://nas.com/public-pages/llms.txt), and `https://nas.com/api/agent/page-context?path={encoded_public_path}`.
7. For authenticated account context, connect the hosted MCP endpoint at `https://mcp.nas.com/mcp`.

## MCP Integration

The official hosted Nas.com MCP endpoint is:

```text
https://mcp.nas.com/mcp
```

OAuth metadata:

```text
https://mcp.nas.com/.well-known/oauth-protected-resource
https://auth.nas.io/.well-known/oauth-authorization-server
```

Supported documented scopes:

- `nas.communities.read`
- `nas.members.read`
- `nas.products.read`
- `nas.orders.read`

After connecting, run MCP discovery before invoking tools:

1. `initialize`
2. `tools/list`
3. `resources/list`
4. `resources/templates/list`

Authenticated discovery is the runtime source of truth.

## MCP Reference Docs

- [MCP installation guide](https://nas.com/mcp)
- [MCP Markdown guide](https://nas.com/mcp.md)
- [MCP agent instructions](https://nas.com/mcp/llms.txt)
- [MCP GitHub reference docs](https://github.com/Nas-Company/nas-mcp)
- [MCP server card](https://nas.com/.well-known/mcp/server-card.json)
- [MCP manifest](https://nas.com/.well-known/mcp.json)

Do not configure MCP clients with `https://nas.com/mcp` or the GitHub repository URL. Configure clients with `https://mcp.nas.com/mcp`.

## Public Boundaries

- Public docs are unauthenticated and read-only.
- Public page context is read-only and should not be treated as private account data.
- OpenAPI discovery describes public discovery resources, not private seller/admin, checkout, payment, or webhook APIs.
- The hosted MCP requires bearer authentication.
- Do not invent API keys, OAuth metadata, dynamic registration, REST contracts, GraphQL contracts, or MCP write tools unless Nas.com publishes them or authenticated MCP discovery returns them.