Incisor Knowledge Base for Codex

Give OpenAI Codex live, up-to-date knowledge of the Incisor® software/game development platform.

This extension connects Codex to the hosted Incisor knowledge base over MCP and automatically detects Incisor projects, so Codex can answer Incisor questions accurately — using the latest API docs, tutorials, example projects, tooltips, and troubleshooting Q&A.

What it does

When it detects an Incisor project, the extension writes two files Codex reads:

AGENTS.md — a managed context block telling Codex about the Incisor KB and its tools:
- search_kb(query, top_k?, docType?) — semantic search over the KB.
- get_doc(id) — fetch the full section for a result.
.codex/config.toml — a project-scoped MCP registration pointing Codex at the hosted server (Codex speaks Streamable HTTP natively, so no bridge is needed):
```
[mcp_servers.incisor-kb]
url = "https://mcp.incisordev.com/mcp"
```

The knowledge base is updated server-side, so you always get the latest Incisor knowledge without updating the extension.

Getting started

Install the extension.
Open an Incisor project. The extension auto-detects it and writes AGENTS.md plus .codex/config.toml. Ask Codex an Incisor question and it will consult the KB.

The default incisorCodex.mcpServerUrl already points at the hosted server, so for most users no settings change is needed.

Codex — trusted projects. Codex applies a project-scoped .codex/config.toml only in trusted projects. If the incisor-kb tools don't appear, trust the project in Codex, then retry.

Commands

Incisor (Codex): Enable KB context for this project — (re)write AGENTS.md and .codex/config.toml.

Settings

Setting	Default	Description
`incisorCodex.mcpServerUrl`	`https://mcp.incisordev.com/mcp`	Hosted Incisor KB MCP endpoint.
`incisorCodex.autoInjectContext`	`true`	Auto-write `AGENTS.md` when an Incisor project is detected.
`incisorCodex.contextFiles`	`["AGENTS.md"]`	Which Codex context files to maintain.
`incisorCodex.writeCodexConfig`	`true`	Write a project-scoped `.codex/config.toml` so Codex picks up the KB server (trusted projects only).

Advanced: it's a standard MCP server

The KB is served by a standard MCP endpoint, so you can also register it globally in ~/.codex/config.toml, or point any other MCP client at the same URL:

[mcp_servers.incisor-kb]
url = "https://mcp.incisordev.com/mcp"

Incisor® is a registered trademark. KB content is subject to the Incisor end user license.