Textavia MCP
@textavia/mcp exposes the Textavia developer tool registry through the Model
Context Protocol. It lets MCP-capable agents call local Textavia utilities for
JSON, Base64, CSV, Markdown tables, regex checks, hashing, text cleanup, case
conversion, random values, timestamps, and privacy scrubbing.
The MCP package is a thin stdio server over the same registry and executors used
by the textavia / txv CLI. It is designed for agents that need dependable
local text and data transformations without copying user data into a web app.
Quick Start
npx @textavia/mcp
Or install it globally:
npm install -g @textavia/mcp
textavia-mcp
Use this MCP server config in clients that accept stdio server definitions:
{
"mcpServers": {
"textavia": {
"command": "npx",
"args": ["-y", "@textavia/mcp"]
}
}
}
If you install globally, you can use the binary directly:
{
"mcpServers": {
"textavia": {
"command": "textavia-mcp"
}
}
}
Registry Metadata
MCP Registry server name:
io.github.caravaca-labs/textavia-mcp
Package:
@textavia/mcp
Transport:
stdio
Repository:
https://github.com/Caravaca-Labs/textavia-cli
What It Exposes
MCP tool names are generated from Textavia registry IDs. The package keeps the
Textavia namespace and uses underscore-separated operation names:
textavia.json_format | dev.json.format | Pretty-print JSON from text or a file. |
textavia.json_validate | dev.json.validate | Validate JSON and return diagnostics. |
textavia.json_repair | dev.json.repair | Repair common malformed JSON output. |
textavia.json_to_types | dev.json.to-types | Generate TypeScript types from sample JSON. |
textavia.base64_encode | encoding.base64.encode | Encode text or bytes as Base64. |
textavia.base64_decode | encoding.base64.decode | Decode Base64 to text or bytes. |
textavia.csv_to_json | data.csv.to-json | Convert CSV text to JSON rows. |
textavia.markdown_table_to_json | data.markdown.table-to-json | Convert Markdown tables to JSON. |
textavia.regex_test | dev.regex.test | Test a JavaScript regex against input text. |
textavia.text_clean | text.clean | Collapse whitespace and normalize pasted text. |
textavia.text_privacy_scrub | text.privacy-scrub | Redact emails, phones, URLs, IPs, and similar data. |
textavia.case_slug | case.slug | Create URL slugs from titles or labels. |
textavia.hash_sha256 | dev.hash.sha256 | Compute SHA-256 digests for text or files. |
textavia.random_uuid | random.uuid | Generate UUIDs. |
Each MCP tool accepts the same argument shape:
{
"input": "text to process",
"file": "optional/path/to/file.txt",
"options": {
"toolSpecificOption": "value"
}
}
Use input for direct text. Use file when the agent should read from disk.
Options are validated against each tool's registry schema.
Example Agent Calls
Format JSON:
{
"input": "{\"name\":\"Ada\",\"tools\":[\"Textavia\"]}",
"options": {
"indent": 2
}
}
Convert CSV to JSON:
{
"input": "name,role\nAda,engineer",
"options": {
"delimiter": ","
}
}
Test a regex:
{
"input": "Textavia 2026",
"options": {
"pattern": "\\d+",
"flags": "g"
}
}
Scrub private text:
{
"input": "Email ada@example.com or call 555-123-4567"
}
Safety Model
- Standard tools run locally in the MCP server process.
- The published stdio command uses local-first defaults.
- Network-required tools are hidden by default.
- Tool arguments are parsed with Zod schemas before execution.
- File input is explicit through the MCP
file argument.
- The package does not include postinstall scripts.
- The package does not require telemetry to run.
The library API exports createTextaviaMcpServer, buildMcpRegistry, and
executeMcpTool for hosts that want tighter filtering, category selection,
network gating, filesystem policy, or maximum input size limits.
Online Tools
Prefer a browser UI or want to inspect a matching web tool? Start here:
Repo Docs
Related Packages
textavia - CLI package with textavia and txv binaries, plus bundled
agent skills.
@textavia/mcp - this MCP stdio server package.
@textavia/core - registry contracts and shared execution types.
@textavia/plugin-standard - built-in local-first tools exposed by the CLI
and MCP server.