Agent Integration

Syphon writes installed MCP servers into the config files used by local coding agents and MCP clients.

Overview

syphon install verifies the package, extracts it under ~/.syphon/packages/<name>/<version>. Pass --link to link it into every detected compatible agent.

$ syphon install github-tools --link
# Linked:
#   claude-code -> ~/.claude.json
#   cursor      -> ~/.cursor/mcp.json
#   codex       -> ~/.codex/config.toml

You can link later with syphon link github-tools, target a specific agent with --framework cursor, or inspect detection with syphon link --list.

Linked Agents

Agent	Config	Key
Claude Code	~/.claude.json or project .mcp.json	mcpServers
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json	mcpServers
Cursor	~/.cursor/mcp.json	mcpServers
Windsurf	~/.codeium/windsurf/mcp_config.json	mcpServers
Gemini CLI	~/.gemini/settings.json	mcpServers
Cline	~/.cline/data/settings/cline_mcp_settings.json or Cline VS Code extension storage	mcpServers
Codex CLI	~/.codex/config.toml	mcp_servers
Zed	~/.config/zed/settings.json	context_servers
Continue	~/.continue/config.yaml	mcpServers
VS Code native MCP	~/.vscode/mcp.json	servers
Goose	~/.config/goose/config.yaml	extensions
Kiro	~/.kiro/settings/mcp.json	mcpServers
Augment / Auggie	~/.augment/settings.json	mcpServers

💡

Syphon creates a one-time .syphon-backup beside an existing config file before writing and verifies the entry after the write.

Typical JSON client entry:

mcp.json

{
  "mcpServers": {
    "github-tools": {
      "command": "node",
      "args": ["/Users/you/.syphon/packages/github-tools/1.0.0/dist/index.js"]
    }
  }
}

Codex TOML entry:

~/.codex/config.toml

[mcp_servers.github-tools]
command = "node"
args = ["/Users/you/.syphon/packages/github-tools/1.0.0/dist/index.js"]

Framework SDKs

LangChain, CrewAI, and OpenAI Agents SDK integrations are library-level integrations rather than app config files. Syphon prints the stdio command and args for these targets:

$ syphon link github-tools --framework openai-agents
$ syphon link github-tools --framework langchain
$ syphon link github-tools --framework crew-ai

Generic MCP

Any MCP-compatible stdio client can run the installed package command directly. Required environment variables are listed in syphon info <name>.

node ~/.syphon/packages/<name>/<version>/dist/index.js
python3 ~/.syphon/packages/<name>/<version>/src/main.py
~/.syphon/packages/<name>/<version>/<binary>

Loading…