# Growth Choice Agent Authentication

> Growth Choice API endpoints and the MCP server are publicly accessible with **no authentication required**. This document describes access methods for AI agents.

## agent_auth

```json
{
  "agent_auth": {
    "access": "public",
    "authentication_required": false,
    "identity_types_supported": ["anonymous"],
    "identity_endpoint": "https://growth-choice.com/api/agent/identity",
    "skill": "https://growth-choice.com/auth.md"
  }
}
```

## Discover

The Growth Choice agent API consists of:

- **MCP Server**: `https://growth-choice.com/api/mcp` — Model Context Protocol (Streamable HTTP, no auth)
- **NLWeb Endpoint**: `https://growth-choice.com/api/ask` — Natural language queries (no auth)
- **OpenAPI Spec**: `https://growth-choice.com/openapi.json` — Full API surface description
- **ARD Catalog**: `https://growth-choice.com/.well-known/ard.json` — All agentic resources
- **Agent Card**: `https://growth-choice.com/.well-known/agent-card.json` — A2A capabilities

## Pick a Method

Growth Choice supports two integration methods:

1. **MCP (recommended)**: Use the MCP streamable HTTP transport at `https://growth-choice.com/api/mcp`
2. **NLWeb**: POST natural-language queries to `https://growth-choice.com/api/ask`

## Register

No registration required. No API key needed. No account creation.

## Claim

No credential claim is required. All endpoints respond to unauthenticated requests.

## Exchange

No token exchange needed. Requests are sent directly to the endpoint.

## Use the Access Token

No access token is needed. Send requests directly:

```bash
# MCP: List available tools
curl -X POST https://growth-choice.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

# NLWeb: Ask a question
curl -X POST https://growth-choice.com/api/ask \
  -H "Content-Type: application/json" \
  -d '{"query":"What Google Ads services does Growth Choice offer?"}'
```

## Errors

The API returns standard HTTP status codes:

- `200` — Successful response
- `400` — Bad request (malformed JSON, missing required fields)
- `404` — Resource not found
- `405` — Method not allowed
- `500` — Internal server error

Error responses include a JSON body:

```json
{
  "jsonrpc": "2.0",
  "error": {
    "code": -32600,
    "message": "Invalid request"
  },
  "id": null
}
```

## Revocation

Not applicable — no credentials are issued.

## Rate Limits

Reasonable use is expected. No hard rate limits are currently enforced. For high-volume agent integrations, contact info@growth-choice.com.

## Contact

- Email: info@growth-choice.com
- MCP Documentation: https://growth-choice.com/mcp
- OpenAPI Spec: https://growth-choice.com/openapi.json