Machine surface · v1.1.0

Edgar's Knowledge MCP

這一頁給人看。真正的 agent 介面仍是同一個 POST /mcp，使用 Descope Agentic OAuth 保護。Human UI 的登入與 MCP OAuth 分開，不共用權限語意。

https://knowledge-mcp.edgars.tools/mcp

Agent 怎麼進來

OAuth discovery → initialize → tools/list → tools/call。匿名 POST 會回 401，不會因為這個說明頁公開而開放知識內容。

Session continuity

continuity_resume 用來接回跨 session 狀態；有價值的 raw turn 或 verified checkpoint 用 continuity_append 落到 Honcho/Neon。

Human UI

搜尋、探索、每日新增走一般 Descope session。這跟 MCP 的 Agentic OAuth 是兩條明確分離的登入路徑。

Live tool contract

bootstrap

Session bootstrap: given a context string describing why the agent was invoked, returns top relevant results from the Agent-KB logical source, Hermes-Wiki Current retrieval projection, and Cloud-KB. Use at session start to selectively load the right knowledge planes.

search

Search across Edgar's knowledge collections. Logical sources: agent-kb (canonical rules projected through Current Knowledge events), hermes-wiki (compiled/current retrieval), cloud-kb (routing). Returns scored result cards with title, snippet, and Knowledge URI.

fetch

Fetch the full content of a search result by its id. The id is the Knowledge URI returned by search.

read

Read a document by a knowledge:// URI. Cloud search results use knowledge://honcho/<id>; Current files use knowledge://<collection>/<path>.

write

Save knowledge that the calling agent judges durable and useful. The submitted content is preserved unchanged, materialized immediately into Current, and submitted to Honcho cloud for semantic retrieval. Archive replication is non-gating. Use target=auto to let the Knowledge worker classify it, or choose hermes-wiki/agent-kb yourself.

continuity_append

Append one ChatGPT user/assistant turn or execution checkpoint to the canonical continuity session in Honcho/Neon. event_id makes retries idempotent; raw content is preserved unchanged.

continuity_resume

Read the latest ChatGPT continuity checkpoint plus recent raw turns/receipts so a new session can continue from verified state instead of reconstructing from summaries.

write_status

Read the durable processing receipt for a previous Knowledge write by receipt ID.