Repository navigation
v1.2.0
TheYgent 1.2 brings an MCP server for coding agents. Add it to Claude Code, Codex, OpenCode or any MCP client, and the coding agent gets TheYgent as tools. It can offload work to your local models, run and build agents, and search your docs and code.
The MCP server (#87)
-
Offload to a local model.
ask_modelsends a prompt to a model on your inference plane and returns its answer.filesattaches local files. The MCP server reads them itself and sends them only to the model, so a long log never enters the coding agent's context; only the answer comes back.think: falseturns a reasoning model's thinking off. On a commit-title prompt that meant 16 generated tokens instead of 417.
-
Run your agents.
list_agents,run_agentandget_runrun any published agent by id or name, on your own models and tools. Every run is traced on the Runs page. -
Build agents.
agent_authoring_guideis generated from the runtime's own node registry.validate_agentapplies the publishing rules locally, andrun_graphtest-runs a document without saving it.create_agentandpublish_agent_versionpublish it.list_samplesandinstall_samplesinstall the sample agents.
What the coding agent builds is an ordinary agent that opens in the editor.
-
Search your docs and code.
create_rag_sourcecreates a retrieval source.add_rag_filestakes files, folders, or globs such asdocs/**/*.md. It skips hidden, dependency and build directories, and names each document by its path in the project.search_raguses the same hybrid retrieval as agents.
In a live run, 21 files were indexed and searchable in about nine seconds.
-
Your machine, your key. The server runs beside the coding tool, over stdio or streamable HTTP, and holds no state. Model calls go straight to the inference plane. Everything else goes to the control plane with a personal API key (
THEYGENT_API_KEY), which acts with your role. -
Setup in one command.
make mcp-setupprints the configuration for Claude Code, Codex and OpenCode, with your checkout's path filled in.
Start with Use TheYgent from coding agents and Tools & recipes, or read the overview and the blog post.
Also in this release
- Retrieval indexes source code (#87). Uploads accept source code and config files: Python, TypeScript/JavaScript, Go, Rust, Java, Swift, C/C++, shell, SQL, YAML, TOML and more. They index as plain text, from the RAG page and from
add_rag_files. - MLX prompt-cache size (#86). A new MLX launch setting,
promptCacheSize, sets how many prompt states the engine keeps for reuse. The default is 10. Raise it when one model serves several agents or concurrent runs. The LLM node docs now explain why a fixedseedcosts prompt reuse on MLX's hybrid models. - New environment variables for the MCP server:
THEYGENT_API_KEY,THEYGENT_MCP_DEFAULT_MODELandTHEYGENT_MCP_RUN_TIMEOUT_S. It also readsTHEYGENT_CONTROL_PLANE_URLandTHEYGENT_INFERENCE_PLANE_URL. - Website. A new coding-agents page, a blog post, and the home page announcement.
Upgrading
No database migrations and no changes to agents or the IR. Nothing to install: the coding tool starts the MCP server with uv run, which syncs the new theygent-mcp package on first use. Follow the setup guide.
Known limits
- No durable runs from the MCP tools.
run_agentandrun_graphstart ordinary runs. Agents with durable-only nodes (human approval, subgraph, loop, map) still run from the interface or the API. - Timeouts. Long agent runs need the coding tool's tool timeout raised. Codex stops a tool call after 60 seconds by default; the setup guide shows where to raise it for each tool.
- Verified clients. Claude Code was verified end to end, with tools called by the model. OpenCode's printed configuration connects (
opencode mcp list). Codex was checked against its documented configuration only.
Full changelog: v1.1.0...v1.2.0