symbiote-hello-world
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@symbiote-hello-world Greet Alice with a personalized hello"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Symbiote MCP example
A local Python tool you can call from Symbiote chat. It takes a name and returns
Hello, <name>!.
Run the MCP server and CLI on your computer. The CLI's microagent connects to Symbiote and forwards tool calls back here for execution.
Install
The MCP server needs Python 3.11+ and FastMCP >=3.2,<4 in its runtime
environment. The setup below installs FastMCP for you. The working example uses
Python 3.12.12 and FastMCP 3.4.7; the dependency versions are recorded in uv.lock.
These requirements apply to the MCP server; the standalone Symbiote CLI bundles
its own runtime.
Studios using Rez can package both the CLI and MCP server; see Studio packaging.
On macOS or Linux, install the Symbiote CLI:
curl -fsSL https://raw.githubusercontent.com/symbiote-labs/symbiote-cli-dist/main/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
symbiote --profile demo versionWith Git and uv installed:
git clone https://github.com/symbiote-labs/symbiote-mcp-example.git
cd symbiote-mcp-example
uv sync --locked --python 3.12Related MCP server: My First MCP
Log in
Use your Symbiote server URL and sign in through the browser:
symbiote --profile demo login --server https://symbiote.example.com --agent-path /agent
symbiote --profile demo statusdemo is a local profile name. Use the same profile in the commands below.
The /agent option depends on your server's routing; omit it for a direct
agent endpoint. Ask your administrator for the correct URL and prefix.
Connect your local tool
cp agent-config.example.yaml agent-config.yaml
uv run python -c 'import shutil; print(shutil.which("symbiote-hello-world"))'Paste the printed executable path into command in agent-config.yaml:
agent:
name: hello-world
mcp_servers:
example:
type: stdio
command: '"/your/checkout/.venv/bin/symbiote-hello-world"'
allowed_paths: []Keep the inner double quotes for paths with spaces. Use an absolute path;
~ and $HOME are not expanded here.
symbiote --profile demo microagent start --config agent-config.yamlYou should see Discovered 1 tool(s) followed by Connected. Leave this
terminal running. The CLI starts the MCP server for you.
Try it in chat
In another terminal, check that hello-world is connected with one tool:
symbiote --profile demo microagent status --jsonOpen Symbiote chat, sign in with the same account as the CLI, and send:
Call
hello-world:example_hello_worldthroughmicroagent_call_toolwithnameset toWorld. Show the actual tool result.
Expected result: Hello, World!
Or send the chat request from a second local terminal:
symbiote --profile demo query 'Call hello-world:example_hello_world through microagent_call_tool with name "World". Show the actual tool result.' --jsonLook for a microagent_call_tool call and a successful tool result containing
Hello, World!. The chat response alone isn't proof that the tool ran.
Stop the proxy with Ctrl+C. Restart it after adding or changing tools. If the connection drops, run the start command again.
Run in your own environment
Run the microagent on a computer that can reach Symbiote and the system your
integration uses. Set command to start your MCP server with the dependencies
and environment it needs. This can be an installed executable or a launcher
script; use absolute paths unless your environment manager supplies PATH.
See Studio packaging for Rez, Conda, and container setups.
The microagent's tools belong to the Symbiote account it logs in with. Another user's chat does not automatically have access to them.
Make it yours
Edit the server. Replace the greeting
with a call to your API, or add another @mcp.tool() function. Types and
docstrings describe the inputs to Symbiote. Prefix tool names for your
integration to avoid collisions.
Return text or JSON-serializable data. Keep stdout for MCP; use a log file for debugging, since the microagent discards stderr. FastMCP's guide covers tool authoring.
Run the local tests:
uv run python -m unittest discover -s tests -vIf discovery finds zero tools, check the executable path and run the tests. If chat can't reach the tool, check the account, profile, and proxy terminal. If the session expires, log in again and restart the proxy.
Available Tools
1 toolexample_hello_worldA
Return a greeting from the local computer running this MCP server.
Inputs: name (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion. The tool's purpose is clearly distinct and unambiguous.
As the sole tool, naming is trivially consistent. The verb_noun pattern is clear and appropriate for the function.
A single tool for a hello-world server is minimal but appropriate, fully covering the narrow scope. It falls slightly short of the typical 3-15 tool range but is justified by the server's simplicity.
The tool fully satisfies the server's stated purpose of returning a greeting. There are no missing operations or dead ends for the hello-world domain.
Related MCP Connectors
Find the right tool for any need across every family and imported API, then call it by name
Search 16,000+ API operations and 95 built tools by need, then call any of them by name
Connect assistants to your workspace knowledge, skills, and work tools.
Connect ChatGPT or Claude to your CRM, store or shipping API. Keys stay out of the chat.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceExposes a greet tool that takes a name and returns a greeting message.ISC
- AlicenseNot gradedqualityBmaintenanceA simple MCP server that exposes a 'greet' tool which returns a friendly greeting for a given name.10 npmISC
- AlicenseNot gradedqualityCmaintenanceEnables a simple greeting tool over MCP, demonstrating schema validation and transport communication.ISC
- AlicenseAqualityCmaintenanceEnables MCP clients to call a simple greeting tool that takes a name and returns personalized text and structured messages via stdio.1ISC