Zypher Agent
A minimal yet powerful framework for creating AI agents with full control over tools, providers, and execution flow.
What is Zypher Agent?
Zypher Agent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to minimal yet powerful framework for creating ai agents with full control over tools, providers, and execution flow.
A minimal yet powerful framework for creating AI agents with full control over tools, providers, and execution flow.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A minimal yet powerful framework for creating AI agents with
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx zypher-agentConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Zypher Agent
Zypher Agent is a minimal, TypeScript-first framework for building AI coding agents that run with full control over tools, LLM providers, and execution flow. Built on Deno and distributed via JSR, it provides built-in file system tools, terminal command execution, native MCP server support with OAuth authentication, and Git-based checkpoints for tracking agent-made changes. Developers who want a lightweight, composable foundation for autonomous coding agents without the overhead of larger frameworks will find Zypher Agent's reactive, Observable-based task streaming well-suited to agentic workflows.
Prerequisites
- Deno 2.0+ installed (https://deno.land/)
- An Anthropic API key (ANTHROPIC_API_KEY) or OpenAI API key (OPENAI_API_KEY)
- Git installed for checkpoint functionality
- An MCP-compatible client or Deno project environment
Add Zypher Agent to your Deno project
Install Zypher Agent from the JSR registry. npm support is planned but not yet available — Deno is currently required.
deno add jsr:@zypher/agentSet your LLM provider API key
Export your Anthropic or OpenAI API key as an environment variable. Zypher Agent uses this to authenticate with the model provider.
export ANTHROPIC_API_KEY="sk-ant-your-key-here"
# or for OpenAI:
export OPENAI_API_KEY="sk-your-key-here"Create an agent with tools
Import Zypher Agent and create an agent instance. The example below uses Claude with the built-in filesystem tools. The `tools` array is fully composable — add custom tools or MCP server connections as needed.
import { createZypherAgent, createFileSystemTools } from "jsr:@zypher/agent";
const agent = await createZypherAgent({
model: "claude-sonnet-4-5-20250929",
tools: [...createFileSystemTools()],
mcpServers: [],
});Run a task and stream events
Use `agent.runTask()` to execute a task. Events stream asynchronously via an Observable pattern, giving you fine-grained control over progress, errors, and completion.
const taskEvents = agent.runTask("Refactor the authentication module to use JWT tokens");
for await (const event of taskEvents) {
console.log(event);
}Integrate MCP servers for extended capabilities
Pass MCP server references in the `mcpServers` array to give your agent access to external tools like sequential thinking, databases, or web search.
const agent = await createZypherAgent({
model: "claude-sonnet-4-5-20250929",
tools: [...createFileSystemTools()],
mcpServers: ["@modelcontextprotocol/sequentialthinking-server"],
});Zypher Agent Examples
Client configuration
Zypher Agent is used as a library in Deno projects rather than as a standalone MCP server with a JSON config block. The following shows a minimal Deno script setup.
{
"mcpServers": {
"zypher-agent": {
"command": "npx",
"args": ["zypher-agent"]
}
}
}Prompts to try
These are example tasks you can pass to `agent.runTask()` or use when integrating Zypher Agent into a larger workflow:
- "Implement authentication middleware with JWT validation in src/middleware/"
- "Audit all files in src/ for unused exports and remove them"
- "Write unit tests for the UserService class covering all public methods"
- "Refactor the database module to use connection pooling"
- "Find all TODO comments in the codebase and create a summary report"Troubleshooting Zypher Agent
Import fails with 'module not found' for jsr:@zypher/agent
Ensure you are using Deno 2.0 or later, which has native JSR support. Run `deno upgrade` to update, then retry `deno add jsr:@zypher/agent`. npm-based Node.js projects are not yet supported.
Agent throws API authentication errors
Verify your `ANTHROPIC_API_KEY` or `OPENAI_API_KEY` environment variable is set and exported in the shell running your Deno script. Check that the model name in `createZypherAgent` matches an available model for your API key tier.
Git checkpoints are not being created during task execution
Ensure the working directory is a Git repository (`git init` if needed) and that Git is installed and accessible in the PATH. Zypher Agent requires a clean or committable Git state to create meaningful checkpoints.
Frequently Asked Questions about Zypher Agent
What is Zypher Agent?
Zypher Agent is a Model Context Protocol (MCP) server that minimal yet powerful framework for creating ai agents with full control over tools, providers, and execution flow. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Zypher Agent?
Follow the installation instructions on the Zypher Agent GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Zypher Agent?
Zypher Agent works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Zypher Agent free to use?
Yes, Zypher Agent is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Zypher Agent Alternatives — Similar Coding Agents Servers
Looking for alternatives to Zypher Agent? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Zypher Agent in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Zypher Agent?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.