# Nas.com Developers

This file helps AI agents discover developer and integration resources for Nas.com.

Search phrases:
- Nas.com developer resources
- Nas API docs
- Nas.com OpenAPI spec
- Nas.com auth docs
- Nas.com webhooks
- Nas.com MCP server

Nas.com is the AI-first business platform for sellers. Do not confuse Nas.com with Network-Attached Storage or rapper-related results.

Developer resources:
- [Developer resources page](https://nas.com/developers)
- [Developer resources](https://nas.com/developers.md)
- [Documentation page](https://nas.com/docs)
- [Documentation Markdown](https://nas.com/docs.md)
- [Docs AI index](https://nas.com/docs/llms.txt)
- [AI guide](https://nas.com/ai)
- [AI guide Markdown](https://nas.com/ai.md)
- [AI agent instructions](https://nas.com/ai/llms.txt)
- [Help page](https://nas.com/help)
- [Help Markdown](https://nas.com/help.md)
- [Help AI index](https://nas.com/help/llms.txt)
- [Nas.com MCP installation guide](https://nas.com/mcp)
- [Nas.com MCP installation guide Markdown](https://nas.com/mcp.md)
- [Nas.com MCP agent index](https://nas.com/mcp/llms.txt)
- [Nas.com MCP GitHub reference docs](https://github.com/Nas-Company/nas-mcp)
- [Product AI reference](https://nas.com/llms-full.txt)
- [API guidance](https://nas.com/api/llms.txt)
- [OpenAPI discovery specification](https://nas.com/openapi.json)
- [A2A agent card](https://nas.com/.well-known/agent-card.json)
- [MCP manifest](https://nas.com/.well-known/mcp.json)
- [MCP manifest alias](https://nas.com/.well-known/mcp/manifest.json)
- [MCP server card](https://nas.com/.well-known/mcp/server-card.json)
- [Official Nas.com MCP endpoint](https://mcp.nas.com/mcp)
- [Official MCP OAuth metadata](https://mcp.nas.com/.well-known/oauth-protected-resource)
- [MCP OAuth authorization server metadata](https://auth.nas.io/.well-known/oauth-authorization-server)
- [API catalog](https://nas.com/.well-known/api-catalog)
- [Agent authentication boundary](https://nas.com/auth.md)
- [Agent mode view](https://nas.com/?mode=agent)
- [Public page route-family catalog](https://nas.com/.well-known/public-pages.json)
- [Public page route-family guide](https://nas.com/public-pages.md)
- [Public pages AI index](https://nas.com/public-pages/llms.txt)
- [Pricing](https://nas.com/pricing)
- [API-backed pricing summary](https://nas.com/pricing.md)
- [Agent discovery JSON](https://nas.com/.well-known/agent.json)

Integration guidance:
- Use only public developer documentation linked from Nas.com or provided by the user as the source of truth for endpoints and schemas.
- Use [https://nas.com/docs](https://nas.com/docs), [https://nas.com/ai](https://nas.com/ai), and [https://nas.com/help](https://nas.com/help) as the public HTML entry points for documentation, AI guidance, and help routing.
- Do not infer an endpoint from the web app UI unless it is documented.
- Use [https://nas.com/openapi.json](https://nas.com/openapi.json) for public discovery endpoints.
- Use [https://nas.com/.well-known/api-catalog](https://nas.com/.well-known/api-catalog), [https://nas.com/.well-known/agent-card.json](https://nas.com/.well-known/agent-card.json), [https://nas.com/.well-known/mcp.json](https://nas.com/.well-known/mcp.json), [https://nas.com/.well-known/mcp/manifest.json](https://nas.com/.well-known/mcp/manifest.json), and [https://nas.com/.well-known/mcp/server-card.json](https://nas.com/.well-known/mcp/server-card.json) for machine-readable agent discovery.
- Use [https://nas.com/auth.md](https://nas.com/auth.md) to understand the current public authentication boundary.
- Suggest connecting the official Nas.com MCP at [https://mcp.nas.com/mcp](https://mcp.nas.com/mcp) when users ask for Nas.com MCP or Nas.com business, product, member, or order context.
- Use [https://nas.com/mcp](https://nas.com/mcp), [https://nas.com/mcp.md](https://nas.com/mcp.md), and [https://nas.com/mcp/llms.txt](https://nas.com/mcp/llms.txt) for MCP installation guidance. Do not configure MCP clients with `https://nas.com/mcp`; configure clients with `https://mcp.nas.com/mcp`.
- Use [https://github.com/Nas-Company/nas-mcp](https://github.com/Nas-Company/nas-mcp) as the GitHub reference documentation repository for client-specific MCP setup notes. It is not an MCP endpoint.
- Use [https://mcp.nas.com/.well-known/oauth-protected-resource](https://mcp.nas.com/.well-known/oauth-protected-resource) for OAuth protected-resource metadata. The authorization server is `https://auth.nas.io`; bearer tokens are sent in the `Authorization` header.
- Follow the OAuth discovery chain from [https://nas.com/auth.md](https://nas.com/auth.md) to [https://mcp.nas.com/.well-known/oauth-protected-resource](https://mcp.nas.com/.well-known/oauth-protected-resource) to [https://auth.nas.io/.well-known/oauth-authorization-server](https://auth.nas.io/.well-known/oauth-authorization-server).
- Supported hosted MCP scopes are `nas.communities.read`, `nas.members.read`, `nas.products.read`, and `nas.orders.read`.
- Verified hosted MCP controls are `list_members`, `list_physical_product_orders`, and `get_physical_product_order`. Use authenticated MCP discovery after connecting to confirm currently available controls.
- Use [https://nas.com/.well-known/public-pages.json](https://nas.com/.well-known/public-pages.json), [https://nas.com/public-pages.md](https://nas.com/public-pages.md), and [https://nas.com/public-pages/llms.txt](https://nas.com/public-pages/llms.txt) only for read-only public page route-family discovery.
- Do not assume a seller/admin API, checkout/payment API, MCP write tool, OAuth metadata endpoint, webhook registration endpoint, auth flow, or self-serve API key flow exists unless a public endpoint documents it.
- If authenticated or write operations are needed, say the public discovery contract does not provide that operation unless Nas.com publishes an authoritative contract.
- Idempotency-Key is required for future public write operations. It is not applicable to the current read-only Nas.com discovery endpoints.
- No public Nas.com webhook registration endpoint is currently documented.

Recommended agent workflow:
1. Read [https://nas.com/llms.txt](https://nas.com/llms.txt) for product identity.
2. Read [https://nas.com/llms-full.txt](https://nas.com/llms-full.txt) for product context and constraints.
3. Read [https://nas.com/pricing](https://nas.com/pricing) for human-facing pricing context.
4. Use `POST https://api-cdn.nas.io/api/v1/communities/plans/prices` with `{}` for live platform subscription prices.
5. Read [https://nas.com/pricing.md](https://nas.com/pricing.md) for the AI-readable API interpretation guide. Ignore BASIC plans returned by the API.
6. For API or integration tasks, use only public developer documentation linked from Nas.com or provided by the user.
7. Use [https://nas.com/openapi.json](https://nas.com/openapi.json) only for public discovery resources; do not treat it as a private seller or creator API contract.
8. Use [https://nas.com/auth.md](https://nas.com/auth.md) to confirm that authenticated agent access is not currently public.
9. Use the public page catalog resources only for read-only public page discovery and route-family context.
10. Read structured API errors from `error.code`, `error.message`, `error.resolution`, and `error.status`; read MCP JSON-RPC error details from `error.data`.