MCP—Model Context Protocol

Your changelog, readable by your agent.

logg ships an MCP server, so Claude Code, Cursor, and Codex can read your release history and write to it. No copy-pasting between a browser tab and an editor — the log is just another thing your agent can reach.

Connect a client

claude — mcp: logg

❯ what shipped in logg last month?

→ tools/call · list_changelogs { project: "logg" }

← 3 entries · v2.2.0 → v2.4.0

Three releases shipped:

v2.4.0 — scheduled digests, signed webhooks

v2.3.0 — audience tabs on public pages

v2.2.0 — the MCP server itself

❯ draft the v2.5.0 entry from the open milestone

→ tools/call · create_changelog

Draft created — features 4 · fixes 2

01—Connect a client

One URL, three editors

Claude Code

Add MCP server

Run this in your terminal — adds logg globally:

claude mcp add --transport http logg https://www.logg.sh/api/mcp

Copy

Authenticate

Start Claude Code. A browser window opens for GitHub sign-in automatically on first use.

Alternative: add to ~/.claude/settings.json

settings.json

{
  "mcpServers": {
    "logg": {
      "type": "http",
      "url": "https://www.logg.sh/api/mcp"
    }
  }
}

02—Tools

Eleven verbs, no surprises

The full dashboard surface, callable. Reads are safe to run freely; writes go through the same validation as the UI.

Tool	Params	Description
create_project	name, slug, description?, githubOwner?, githubRepo?	Create a project. Omit the GitHub fields for a manual log.
list_projects	—	Every project you can reach.
get_project	projectId	Full project detail.
list_changelogs	projectId	Entries for one project, newest first.
get_changelog	projectId, changelogId	The complete body of a single entry.
create_changelog	projectId, version, content, title?	Write a new entry by hand.
update_changelog	projectId, changelogId, title?, content?, summary?, categories?	Revise an entry in place.
publish_changelog	projectId, changelogId	Move a draft onto the public page.
unpublish_changelog	projectId, changelogId	Pull an entry back to draft.
sync_project	projectId	Pull new GitHub releases and draft entries for them.
generate_changelog	projectId, changelogId	Rewrite one entry from its source commits.

03—OAuth

2.1 with PKCE, handled for you

Compliant clients complete the handshake on their own. The endpoints below are listed for anyone wiring a client by hand; tokens expire after an hour and clients re-authenticate silently.

DiscoveryGET /.well-known/oauth-authorization-server

ResourceGET /.well-known/oauth-protected-resource

AuthorizeGET /api/oauth/authorize

TokenPOST /api/oauth/token