Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/synpulse8-opensource/pulse8-ai-cortex-knowledge-vault/cortex-authnpx skills add synpulse8-opensource/pulse8-ai-cortex-knowledge-vault --skill cortex-authgit clone --depth 1 https://github.com/synpulse8-opensource/pulse8-ai-cortex-knowledge-vaultWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/synpulse8-opensource/pulse8-ai-cortex-knowledge-vault/cortex-auth)<a href="https://agentmods.dev/skills/synpulse8-opensource/pulse8-ai-cortex-knowledge-vault/cortex-auth"><img src="https://agentmods.dev/badge/skills/synpulse8-opensource/pulse8-ai-cortex-knowledge-vault/cortex-auth.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00042 | $0.00510 |
| Opus 5 | $0.00021 | $0.00255 |
| Sonnet 5 | $0.00008 | $0.00102 |
| Haiku 4.5 | $0.00004 | $0.00051 |
Grade A, and why
cortex-auth scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
Clients (Cursor, curl) must send `x-api-key` on `POST /mcp/` and subsequent MCP requests. What it actually says
Cortex auth
Configuration (cortex/config.py)
Env (also CORTEX_*) |
Field | Purpose |
|---|---|---|
AUTH_METHOD |
auth_method |
none, apikey, oidc |
API_KEY |
api_key |
Shared secret for REST + MCP |
OIDC_* |
oidc_* |
Provider URLs, client id/secret, redirect |
Loaded via Pydantic Settings with CORTEX_ prefix and unprefixed aliases in .env.
REST middleware
cortex/auth/middleware.py — AuthMiddleware on FastAPI app.
Public paths (no auth):
/api/v1/health,/api/v1/login,/api/v1/auth/callback/mcp,/.well-known/,/docs,/redoc,/openapi.json
Protected: all other /api/v1/*
| Mode | Client sends |
|---|---|
apikey |
Header x-api-key: <API_KEY> |
oidc |
Authorization: Bearer <token>; API key accepted as fallback if set |
none |
No credentials |
MCP auth
cortex/mcp/http_server.py — ApiKeyGuardMiddleware when auth_method == apikey.
Clients (Cursor, curl) must send x-api-key on POST /mcp/ and subsequent MCP requests.
OIDC flow
GET /api/v1/login→ redirect to IdPGET /api/v1/auth/callback→ exchange code, issue session/token- Use bearer token on API calls
FastMCP may use OIDCProxy for browser-based MCP login in oidc mode.
Local development
AUTH_METHOD=none # simplest
# or
AUTH_METHOD=apikey
API_KEY=dev-secret
scripts/env_check.sh prompts for auth-related vars when applying defaults.
Related skills
- MCP HTTP:
cortex-mcp - Deploy secrets:
cortex-deploy
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 4d ago First seen · 66 lines · 42 tokens per session scan A eb8526c70bd6
cortex-auth is a skill published in the GitHub repository synpulse8-opensource/pulse8-ai-cortex-knowledge-vault (14 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 42 tokens to every session and 510 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
background-task
Add or modify work that runs outside the request/response cycle — emails, document ingestion, webhooks, cleanups, scheduled jobs. Use when something is slow or fire-and-forget, or when adding a periodic/cron task. This project's queue is {{ cookiecutter.backgroundtasks }}.
frontend-feature
Build a new page, view, or data-driven feature in the Next.js frontend. Use when adding a route under the dashboard/marketing area, wiring UI to a backend endpoint, adding client state, or creating a localized page. Covers App Router, data fetching, Zustand stores, and i18n.
pytest-suite
Write or extend the backend test suite following this project's conventions. Use when adding tests for a new service/route/repository, when coverage is missing, or when asked to test a feature. Knows the mocked-session + httpx AsyncClient setup so tests run with no database.
rag-knowledge
Work with the RAG knowledge base — ingest documents, run semantic search, manage collections, or add a sync source/connector (Google Drive, S3). Use when populating or debugging the knowledge base, tuning retrieval, or adding a new document source. This project uses {{ cookiecutter.vectorstore }} + {{…
alembic-migration
Create, review, and apply database schema changes with Alembic. Use whenever a SQLAlchemy model is added or changed, a column/index/constraint needs to change, or a data backfill is required — anything that alters the PostgreSQL schema.
billing-stripe
Work with Stripe billing — subscriptions, plans/prices, the Customer Portal, credits, usage metering, invoices, and webhook events. Use when changing plans, handling a new Stripe webhook, debugging a payment/subscription flow, or touching credit balances and usage.