WinTerm MCP
Click on "Install 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., "@WinTerm MCPlist files in the current directory"
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.
WinTerm MCP
A Model Context Protocol server that provides programmatic access to the Windows terminal. This server enables AI models to interact with the Windows command line interface through a set of standardized tools.
Features
Write to Terminal: Execute commands or write text to the Windows terminal
Read Terminal Output: Retrieve output from previously executed commands
Send Control Characters: Send control signals (e.g., Ctrl+C) to the terminal
Windows-Native: Built specifically for Windows command line interaction
Related MCP server: iTerm MCP
Installation
Clone the Repository:
git clone https://github.com/capecoma/winterm-mcp.git cd winterm-mcpInstall Dependencies:
npm installBuild the Project:
npm run buildConfigure Claude Desktop:
Add the server config to %APPDATA%/Claude/claude_desktop_config.json:
{
"mcpServers": {
"github.com/capecoma/winterm-mcp": {
"command": "node",
"args": ["path/to/build/index.js"],
"disabled": false,
"autoApprove": []
}
}
}Note: Replace "path/to/build/index.js" with the actual path to your built index.js file.
Available Tools
write_to_terminal
Writes text or commands to the terminal.
{
"command": "echo Hello, World!"
}read_terminal_output
Reads the specified number of lines from terminal output.
{
"linesOfOutput": 5
}send_control_character
Sends a control character to the terminal (e.g., Ctrl+C).
{
"letter": "C"
}Development
For development with auto-rebuild:
npm run devLicense
MIT License - see LICENSE file.
Available Tools
3 toolsread_terminal_outputC
Read the output from the terminal
| Name | Required | Description | Default |
|---|---|---|---|
| linesOfOutput | Yes | Number of lines of output to read |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It only states the action ('Read') without details on permissions, side effects, or response format. This is inadequate for a tool that interacts with terminal output, as it omits critical context like whether it reads recent or historical output, or if it requires specific terminal states.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence with zero waste. It is front-loaded and directly states the tool's function without unnecessary elaboration, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of annotations and output schema, the description is incomplete. It fails to address behavioral aspects like what 'output' entails, potential errors, or return values. For a tool with a parameter and no structured safety hints, more context is needed to guide effective use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, clearly documenting the 'linesOfOutput' parameter. The description adds no additional meaning beyond the schema, such as explaining typical values or constraints. Baseline 3 is appropriate since the schema does the heavy lifting, but no extra value is added.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states the action ('Read') and target ('output from the terminal'), which clarifies the tool's basic function. However, it lacks specificity about what 'output' means (e.g., recent output, buffered content) and does not differentiate from sibling tools like 'write_to_terminal' or 'send_control_character', leaving room for ambiguity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. The description does not mention prerequisites (e.g., terminal must be active), exclusions, or comparisons to siblings like 'write_to_terminal' for input operations, leaving the agent without context for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
send_control_characterC
Send a control character to the terminal
| Name | Required | Description | Default |
|---|---|---|---|
| letter | Yes | The letter corresponding to the control character (e.g., "C" for Ctrl+C) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden but offers minimal behavioral insight. It states the action but doesn't disclose effects (e.g., whether it interrupts execution, sends signals, or modifies terminal state), permissions needed, or error conditions. This is inadequate for a mutation tool with zero annotation coverage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, direct sentence with no wasted words, making it highly concise and front-loaded. Every word contributes to stating the tool's purpose efficiently.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (a mutation with potential side effects), lack of annotations, and no output schema, the description is incomplete. It fails to explain what happens after sending the character, possible outcomes, or error handling, leaving significant gaps for agent understanding.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with the parameter 'letter' fully documented in the schema. The description adds no additional parameter semantics beyond what the schema provides, such as examples beyond 'C' or constraints on valid letters, so it meets the baseline for high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Send') and target ('control character to the terminal'), making the purpose immediately understandable. It distinguishes from sibling tools like 'read_terminal_output' (reading) and 'write_to_terminal' (writing text), but doesn't explicitly contrast with them in the description itself.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. The description doesn't mention scenarios like interrupting processes (Ctrl+C), signaling end-of-file (Ctrl+D), or other terminal control contexts, nor does it reference sibling tools for comparison.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
write_to_terminalC
Write text or commands to the terminal
| Name | Required | Description | Default |
|---|---|---|---|
| command | Yes | The text or command to write to the terminal |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states the action ('write') but doesn't clarify if this executes commands, requires specific permissions, has side effects, or how it interacts with the terminal state. This is inadequate for a tool that likely involves system interaction.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence with zero waste. It is front-loaded and appropriately sized for the tool's simplicity, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of annotations and output schema, the description is incomplete. It doesn't address behavioral aspects like whether commands are executed, error handling, or return values, which are critical for a terminal interaction tool. The schema covers parameters well, but overall context is insufficient.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 100%, so the schema already documents the single parameter 'command' as 'The text or command to write to the terminal'. The description adds no additional meaning beyond this, such as examples or constraints, but the schema provides sufficient baseline information.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb ('write') and resource ('to the terminal'), specifying the action and target. However, it doesn't differentiate from sibling tools like 'send_control_character' which might also involve terminal interaction, leaving room for ambiguity about when to use each.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives like 'send_control_character' or 'read_terminal_output'. It lacks context about use cases, prerequisites, or exclusions, leaving the agent to infer usage from the tool name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
3 tool updates
v1.0.0- Added
read_terminal_output - Added
send_control_character - Added
write_to_terminal
TDQS
Each tool has a clearly distinct purpose with no overlap: reading output, sending control characters, and writing text/commands are three separate terminal operations. An agent can easily tell them apart based on their specific functions.
All tools follow a consistent verb_noun pattern (read_terminal_output, send_control_character, write_to_terminal) with snake_case throughout. The naming is predictable and readable across the set.
Three tools is slightly thin but reasonable for a terminal-focused server, covering core input/output and control operations. It feels minimal but not incomplete, as each tool earns its place for basic terminal interaction.
The tools cover the essential terminal operations: reading, writing, and control. A minor gap might be the lack of a tool for managing terminal sessions or configuration, but for basic interaction, the surface is largely complete without dead ends.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
The Telnyx MCP server is an official implementation of the Model Context Protocol that enables AI clients (like Claude Desktop, Cursor, and OpenAI Agents) to interact with Telnyx's telephony, messaging, and AI assistant APIs. It provides comprehensive capabilities including making and managing phone calls, sending SMS/MMS messages, purchasing and configuring phone numbers, creating AI assistants with custom instructions, managing cloud storage buckets, scraping and embedding website content, and handling integration secrets. The server exists as both a local implementation and a remotely hosted version, allowing developers to integrate real-world communication infrastructure directly into AI applications.
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Related MCP Servers
- AlicenseBqualityFmaintenanceA Model Context Protocol server that provides secure command-line access to Windows systems, allowing MCP clients like Claude Desktop to safely execute commands in PowerShell, CMD, and Git Bash shells with configurable security controls.91,215269MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that gives AI models access to your iTerm terminal session, allowing them to read output, write commands, and send control characters.3110MIT
- AlicenseAqualityCmaintenanceA Model Context Protocol server that enables AI assistants to interact with iTerm2 terminals, allowing creation and management of terminal sessions, command execution, and reading terminal output.53314ISC
- AlicenseAqualityFmaintenanceA secure Model Context Protocol server that allows AI models to safely interact with Windows command-line functionality, enabling controlled execution of system commands, project creation, and system information retrieval.810MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/capecoma/winterm-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server