6DuckLearn MCP server

6DuckLearn MCP

Official public setup docs, registry metadata, and local connector package for 6DuckLearn integrations.

This repository contains two separate integrations: Hosted MCP lets Codex use 6DuckLearn tools; the AI Runtime Connector lets Agent Console send work to Codex, Hermes, or OpenClaw.

Use 6ducklearn as the local client key in Codex or Claude Code. The official MCP Registry name is com.6ducklearn/mcp, and the hosted endpoint is:

https://6ducklearn.com/mcp

This repository is intentionally hosted-first. It does not contain the private 6DuckLearn SaaS backend, Supabase edge functions, service-role database access, billing logic, user memory store, or production deployment scripts.

Quick Start

Codex

From GitHub:

npx github:kit18/6ducklearn-mcp setup-codex

This configures the hosted 6DuckLearn MCP server in local Codex, adds the hosted OAuth compatibility header, and starts the OAuth login flow. If a matching, authenticated 6ducklearn hosted entry already exists, the setup command keeps it in place and does not reopen OAuth. A different local or stdio entry is replaced, while a matching but signed-out entry resumes OAuth, so repeated setup stays deterministic without creating duplicates.

Manual fallback:

Do not use codex mcp add for this fallback: current Codex versions can start OAuth immediately from that command, before explicit scopes are supplied. Inspect the entry first with codex mcp get 6ducklearn --json:

• If it is missing, add the full block below to ~/.codex/config.toml.
• If it already uses the URL below, keep its server table and add only the missing http_headers table.
• If it uses another URL or transport, run codex mcp remove 6ducklearn, then add the full block.

[mcp_servers.6ducklearn]
url = "https://6ducklearn.com/mcp"

[mcp_servers.6ducklearn.http_headers]
User-Agent = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125 Safari/537.36"

Start only the explicitly scoped login:

codex mcp login 6ducklearn --scopes mcp:read,mcp:write,approval:request

Claude Code

claude mcp add --transport http 6ducklearn https://6ducklearn.com/mcp

Then open the MCP tool picker in Claude Code and authorize 6DuckLearn when prompted.

npm Package Status

The npm packages @6ducklearn/mcp and @6ducklearn/connector are not published yet. Until npm publication is available, use the GitHub npx command above for copy/paste setup.

Hosted MCP Identity

• local client key: 6ducklearn
• MCP Registry name: com.6ducklearn/mcp
• title: 6DuckLearn MCP
• MCP URL: https://6ducklearn.com/mcp
• OAuth discovery: https://6ducklearn.com/.well-known/oauth-authorization-server
• protected resource metadata: https://6ducklearn.com/.well-known/oauth-protected-resource/mcp

The public Codex helper requests only mcp:read, mcp:write, and approval:request. Control-plane access and local-runtime authorization use separate, explicitly named flows; the hosted-MCP setup never requests approval:decide. A protected write is submitted to 6DuckLearn Inbox with a server-issued approval ID. The human decides there, then Codex calls resumeapprovedwrite with only that ID to execute the locked request once.

What Agents Can Do

6DuckLearn MCP gives connected agents account-authorized workflows for research, organization, reminders, portfolio review, knowledge retrieval, canvas creation, and Skill Builder discovery. Finance research includes bounded stock-research bundles and issuer-grounded Hong Kong credit-card evaluation when those capabilities are enabled for the connected account.

For the full public catalog, see MCP tool use cases. The catalog describes each tool by practical use case and example prompt without exposing private schemas or backend implementation details.

Shortened. The full README is on GitHub.