# NewsJack agent authentication

NewsJack exposes owner-scoped Agent Operations through its hosted MCP endpoint.

## Endpoints

- Issuer: `https://newsjack.cc`
- Authorisation: `https://newsjack.cc/api/auth/oauth/authorize`
- Token: `https://newsjack.cc/api/auth/oauth/token`
- Token revocation: `https://newsjack.cc/api/auth/oauth/revoke`
- Client and API key registration: `https://newsjack.cc/api/auth/agent-register`

## API keys

Create an API key while signed in at `https://newsjack.cc/dashboard/settings/destinations`.
Send the key as a bearer token:

```http
Authorization: Bearer nj_ak_your_key
```

The raw key is shown once. NewsJack stores its SHA-256 hash and will not display the
secret again.

## OAuth 2.1

NewsJack supports the authorisation code flow with PKCE, refresh tokens, and owner-bound
client credentials. Supported scopes are:

- `read:stories`
- `generate:posts`
- `roast:posts`
- `manage:sources`
- `manage:schedule`
- `read:voice`
- `manage:voice`

Registering a confidential client requires a signed-in NewsJack browser session. Send
`client_name` and one or more `redirect_uris` to the registration endpoint. The returned
client secret is shown once. A client-credentials token is issued only when that client
has an owning NewsJack account and the token has been stored successfully.

## Hosted MCP endpoint

Send JSON-RPC 2.0 requests to `https://newsjack.cc/api/mcp`. The `newsjack-mcp` npm
package is a stdio adapter over this hosted authority and needs only `NEWSJACK_API_KEY`.

## Support

Email `support@newsjack.cc`.
