# Sampoorna Intelligence — Agent Authentication

Sampoorna is **funder intelligence for Indian NGOs** — where to go next, and who to go with. Public marketing content on `sampoornaintelligence.com` is open to crawlers. **All funding intelligence APIs require NGO authentication.**

## Human users

1. Open https://app.sampoornaintelligence.com/login
2. Sign in with email and password (trial or annual subscription)
3. The workspace issues JWT access tokens used against `https://api.sampoornaintelligence.com/api`

## Machine / agent access

Protected resources live at:

- **Resource server**: `https://api.sampoornaintelligence.com`
- **Authorization server metadata**: `/.well-known/oauth-authorization-server` (on this domain)
- **Protected resource metadata**: `/.well-known/oauth-protected-resource` (on this domain)
- **API catalog**: `/.well-known/api-catalog` (on this domain)

### Obtaining tokens

Agents must use credentials issued to an NGO partner account. Token endpoint:

```
POST https://api.sampoornaintelligence.com/api/auth/login
Content-Type: application/json

{"email": "<ngo_user_email>", "password": "<password>"}
```

Response includes `access_token` (JWT). Send on API requests:

```
Authorization: Bearer <access_token>
```

### Scopes and isolation

- `ngo_id` is embedded in the JWT — clients cannot query another NGO's packets or briefs
- National sector data requires login; per-user rate limits apply
- Suspended accounts receive `403` with `code: access_suspended` — contact founder@sampoornaintelligence.com

### Agent registration

Automated agent onboarding is not open to the public. Partnership inquiries:

- Email: founder@sampoornaintelligence.com
- Marketing contact form: https://sampoornaintelligence.com/#chapter-vi

## Public endpoints (no auth)

- This site: `/`, `/llms.txt`, `/robots.txt`, `/sitemap.xml`, `/.well-known/*` discovery files
- API health (if exposed): `GET https://api.sampoornaintelligence.com/api/health`

## Content signals

See `/robots.txt`: `ai-train=no, search=yes, ai-input=yes` — cite and summarize marketing content; do not use for model training without permission.