tty-table MCP
The MCP server formats an agent’s rows as a text table with wrapping, alignment and a chosen width for terminal display.
- 311 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The client launches a local npm package and passes report rows to it.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/tty-table-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The client launches a local npm package and passes report rows to it.
This is third-party code. Review the repository files before installing.
What it does
tty-table MCP turns agent-supplied structured data into a table for a terminal or text report. The agent sends rows, optional headers and formatting settings, then receives ready text without manually aligning spaces. Width follows visible terminal columns, including wide Unicode characters. The server wraps text and draws borders using the supplied options. The package also includes a CLI and a JavaScript library for application use.
Who it is for. Terminal-report authors presenting long values and numeric columns in readable tables.
Good fit when
- Check results need aligned columns in an agent’s text response.
- Long names exceed terminal width and need wrapping.
- Mixed Latin and wide characters break borders when measured by string length.
- A compact table needs to fit a predetermined display width.
Not a fit when
- You need a plotted chart with image export.
- The agent must retrieve database data without a database connection.
- The user needs an editable Excel workbook with formulas.
Example request
Format these test results in an 80-column table, right-align durations and wrap long names.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
Current package releases require Node.js 22 or newer for both MCP and CLI use. The server accepts prepared rows from the agent and does not connect to a data source itself. Output is a text table without interactive cell editing or spreadsheet formulas. Wide characters and color sequences are measured according to terminal display rules, so the result can appear differently in a proportional font.
How to disable. Remove tty-table from the MCP client and stop its process. Existing text reports remain unchanged.
FAQ
Are headers required?
No. Rows are required; headers are optional. Add them when column meanings would otherwise be unclear.
What row formats are accepted?
Cell arrays or objects keyed by column names. Use a consistent format for the report.
How do I right-align numbers?
Set right alignment for the relevant header or column and inspect the result in a monospace font.
Are there other MCP tools?
The guide currently documents `render_table` only. Inspect your version’s tool list before planning other actions.
Do color codes consume column width?
No. ANSI sequences are excluded from width measurement. View the report in a terminal supporting the chosen styling.
Discussion
No questions or reviews yet.
Related
MCP serversA desktop SQL workspace with a built-in MCP server: the agent reads the schema and runs queries in the same client you already use
MCP server that gives an agent access to MySQL: schema inspection and queries, read-only by default, writes behind flags
A Python MCP server for MySQL: listing tables, reading data, running SQL and inspecting schema through a controlled interface
One MCP server for SQLite, SQL Server, PostgreSQL and MySQL: read and change data, edit schemas and export to CSV and JSON
dbt MCP
dbt-mcp
The official MCP server from dbt Labs: the Semantic Layer, project metadata, dbt commands and SQL against the warehouse from an agent
MCP server and CLI that turns paper text or data into academic figures, diagrams and plots
README in short
The library provides ESM and CommonJS entry points. A browser bundle can render the same kind of table in a page’s console.