Tactics Journal API

Tactics Journal exposes a small set of public HTTP endpoints for subscription and account flows.

Base URL

https://tacticsjournal.com

Discovery

• API catalog: /.well-known/api-catalog
• OpenAPI description: /openapi.json
• Health: /api/health
• Agent skills index: /.well-known/agent-skills/index.json
• MCP server card: /.well-known/mcp/server-card.json

Public endpoints

GET /api/health

Returns a simple health payload.

POST /api/subscribe

Subscribes an email address to Tactics Journal updates.

Accepted content types:

• application/json
• application/x-www-form-urlencoded
• multipart/form-data

Example JSON body:

{
  "email": "[email protected]",
  "tag": ["opinion", "research", "weekly-recap"]
}

POST /api/account/start

Starts the passwordless account sign-in flow by emailing a magic link.

Example JSON body:

{
  "email": "[email protected]",
  "next": "/research/"
}

GET /account/finish?token=...&next=...

Consumes a magic-link token, sets the session cookie, and redirects.

GET /api/account/session

Returns the current cookie-backed session state.

POST /api/account/signout

Clears the current session cookie.

Authentication model

The site currently uses cookie-based passwordless sessions for browser account access. It does not yet expose a standards-compliant OAuth 2.0 or OpenID Connect authorization server.

Markdown for agents

HTML pages support content negotiation. Send:

Accept: text/markdown

to receive a markdown representation with:

• Content-Type: text/markdown
• x-markdown-tokens token estimate header