Skip to content

The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.

fix(embed): the MCP example links the tinymcp module

M3gA-Mindc8373f53b24a
diff --git a/crates/openhuman-embed/examples/README.md b/crates/openhuman-embed/examples/README.md
index 6c3f68146c..8e9080b73b 100644
--- a/crates/openhuman-embed/examples/README.md
+++ b/crates/openhuman-embed/examples/README.md
@@ -14,7 +14,7 @@
- [Host tools and HostOnly keep the advertised tool catalog exact](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/host_tools.rs): Host tools and HostOnly keep the advertised tool catalog exact. (offline with loopback stubs; no live path.)
- [Lean runtime without background services](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/lean_headless.rs): Lean runtime without background services. (offline with loopback stubs; optional live via OPENHUMAN_EXAMPLE_LIVE.)
- [Linux agent fleet memory and latency](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/linux_fleet.rs): Measure retained runtime-owned agents using loopback inference and two worker threads. (offline on Linux; use a fresh constrained cgroup for release measurements.; feature: storage-sqlite)
-- [Connect an actual MCP protocol stub over loopback](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/mcp.rs): Connect an actual MCP protocol stub over loopback. (offline with loopback stubs; no live path.; feature: mcp)
+- [Connect an actual MCP protocol stub over loopback](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/mcp.rs): Connect an actual MCP protocol stub over loopback. (offline with loopback stubs; no live path.; feature: mcp,storage-sqlite)
- [Tenant scoped memory facade with an in-memory engine](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/memory.rs): Tenant scoped memory facade with an in-memory engine. (offline with loopback stubs; no live path.)
- [SaaS profiles isolate conversation history](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/profiles.rs): SaaS profiles isolate conversation history. (offline with loopback stubs; no live path.; feature: channels,storage-sqlite)
- [Hello agent: a prompt in and a reply out](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/run_turn.rs): Hello agent: a prompt in and a reply out. (offline; optional live via OPENHUMAN_EXAMPLE_LIVE=1 and BASE_URL/API_KEY/MODEL.)
diff --git a/crates/openhuman-embed/examples/mcp.rs b/crates/openhuman-embed/examples/mcp.rs
index 2937ec4e24..9acc07677c 100644
--- a/crates/openhuman-embed/examples/mcp.rs
+++ b/crates/openhuman-embed/examples/mcp.rs
@@ -1,9 +1,10 @@
//! Title: Connect an actual MCP protocol stub over loopback
//! Summary: Connect an actual MCP protocol stub over loopback.
//! Run: offline with loopback stubs; no live path.
-//! Feature: mcp
+//! Feature: mcp,storage-sqlite
mod support;
+use openhuman_core::config::schema::{ModuleOverride, ModuleSourceMode};
use openhuman_embed::{AgentSpec, Runtime, Workspace};
fn main() -> anyhow::Result<()> {
@@ -13,8 +14,18 @@ fn main() -> anyhow::Result<()> {
async fn run() -> anyhow::Result<()> {
let backend = support::stub_backend().await;
let provider = support::provider("hello from the stub").await;
+ // MCP runs in the tinymcp module. A released build downloads it; this
+ // offline example links it in instead, and the module keeps its state in
+ // the workspace's default (SQLite) storage.
+ openhuman_embed::modules::register_linked("tinymcp", tinymcp::linked_module);
+ let mut config = support::offline_config();
+ config.modules.allow_download = false;
+ config.modules.overrides.push(ModuleOverride::with_source(
+ "tinymcp",
+ ModuleSourceMode::Linked,
+ ));
let runtime = Runtime::builder()
- .config(support::offline_config())
+ .config(config)
.workspace(Workspace::Ephemeral)
.backend_url(backend.uri())
.provider(support::route(&provider, "fixture"))
diff --git a/docs/gitbooks/en/developing/embed/cookbook.md b/docs/gitbooks/en/developing/embed/cookbook.md
index 9a7f8fd3f2..590ec11c76 100644
--- a/docs/gitbooks/en/developing/embed/cookbook.md
+++ b/docs/gitbooks/en/developing/embed/cookbook.md
@@ -88,9 +88,9 @@ Run: `cargo run -p openhuman-embed --release --example linux_fleet --no-default-
Connect an actual MCP protocol stub over loopback.
-[Source](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/mcp.rs) · offline with loopback stubs; no live path. · feature: mcp
+[Source](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/mcp.rs) · offline with loopback stubs; no live path. · feature: mcp,storage-sqlite
-Run: `cargo run -p openhuman-embed --example mcp --features mcp`
+Run: `cargo run -p openhuman-embed --example mcp --features mcp,storage-sqlite`
## Tenant scoped memory facade with an in-memory engine
diff --git a/llms-full.txt b/llms-full.txt
index 60871a1f71..414d664a9d 100644
--- a/llms-full.txt
+++ b/llms-full.txt
@@ -2698,9 +2698,9 @@ Run: `cargo run -p openhuman-embed --release --example linux_fleet --no-default-
Connect an actual MCP protocol stub over loopback.
-[Source](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/mcp.rs) · offline with loopback stubs; no live path. · feature: mcp
+[Source](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/mcp.rs) · offline with loopback stubs; no live path. · feature: mcp,storage-sqlite
-Run: `cargo run -p openhuman-embed --example mcp --features mcp`
+Run: `cargo run -p openhuman-embed --example mcp --features mcp,storage-sqlite`
## Tenant scoped memory facade with an in-memory engine
@@ -3200,7 +3200,7 @@ The compiled capability report describes this build:
- [Host tools and HostOnly keep the advertised tool catalog exact](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/host_tools.rs): Host tools and HostOnly keep the advertised tool catalog exact. (offline with loopback stubs; no live path.)
- [Lean runtime without background services](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/lean_headless.rs): Lean runtime without background services. (offline with loopback stubs; optional live via OPENHUMAN_EXAMPLE_LIVE.)
- [Linux agent fleet memory and latency](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/linux_fleet.rs): Measure retained runtime-owned agents using loopback inference and two worker threads. (offline on Linux; use a fresh constrained cgroup for release measurements.; feature: storage-sqlite)
-- [Connect an actual MCP protocol stub over loopback](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/mcp.rs): Connect an actual MCP protocol stub over loopback. (offline with loopback stubs; no live path.; feature: mcp)
+- [Connect an actual MCP protocol stub over loopback](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/mcp.rs): Connect an actual MCP protocol stub over loopback. (offline with loopback stubs; no live path.; feature: mcp,storage-sqlite)
- [Tenant scoped memory facade with an in-memory engine](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/memory.rs): Tenant scoped memory facade with an in-memory engine. (offline with loopback stubs; no live path.)
- [SaaS profiles isolate conversation history](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/profiles.rs): SaaS profiles isolate conversation history. (offline with loopback stubs; no live path.; feature: channels,storage-sqlite)
- [Hello agent: a prompt in and a reply out](https://github.com/tinyhumansai/openhuman/blob/main/crates/openhuman-embed/examples/run_turn.rs): Hello agent: a prompt in and a reply out. (offline; optional live via OPENHUMAN_EXAMPLE_LIVE=1 and BASE_URL/API_KEY/MODEL.)