@intenttext/mcp-server

What is IntentText?

IntentText (.it) is a plain-text document format where every line has a declared semantic type — making documents simultaneously human-writable and natively JSON. A task: is a task. A step: is an executable workflow step. Every block parses to typed, deterministic JSON with no interpretation required.

This MCP server gives any AI agent the ability to work with IntentText documents as native tool calls.

Deployed instance: https://intenttext-mcp.onrender.com — use this URL directly in any MCP client that supports remote servers.

MCP server for IntentText — parse, validate, query, render, and generate .it documents from any AI agent.

With this server running, Claude, GPT, or any MCP-compatible agent can work with IntentText documents as native tool calls — without needing to understand the format itself.

Installation

npm install -g @intenttext/mcp-server
# or use npx (no install required)
npx @intenttext/mcp-server

Configure with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "intenttext": {
      "command": "npx",
      "args": ["@intenttext/mcp-server"]
    }
  }
}

Configure with any MCP client

{
  "command": "npx",
  "args": ["@intenttext/mcp-server"],
  "env": {}
}

HTTP Wrapper (for hosted MCP URLs)

This package also includes an HTTP wrapper so you can deploy it from this GitHub repo to platforms like Railway/Render/Fly and provide a URL (for directories that ask for https://.../mcp).

npm install
npm run build
npm run start:http

Endpoints:

• POST /mcp - MCP Streamable HTTP endpoint
• GET /health - health check endpoint

Environment variables:

• PORT (default 3000)
• HOST (default 0.0.0.0)

Note: GitHub itself cannot host a long-running Node server process. Keep the wrapper code in GitHub, then deploy it to a runtime provider and use that public URL in Smithery forms.

The public deployment is available at https://intenttext-mcp.onrender.com.

Available Tools

parse_intent_text

Parse an IntentText (.it) source string into a structured JSON document.

| Parameter | Type | Description | | --------- | ------- | ------------------------------------------------------------------------ | | source | string | The IntentText source string to parse | | safe | boolean | If true, never throw — returns warnings instead of errors. Default: true |

render_html

Render an IntentText source string to styled HTML.

| Parameter | Type | Description | | --------- | ------ | ------------------------------------- | | source | string | IntentText source string (.it format) |

render_print

Render an IntentText document to print-optimised HTML with @media print CSS. Suitable for PDF generation.

| Parameter | Type | Description | | --------- | ------ | ------------------------ | | source | string | IntentText source string |

merge_template

Merge an IntentText template (containing {{variable}} placeholders) with a data object.

| Parameter | Type | Description | | ---------- | ------ | -------------------------------------------------------------------------------- | | template | string | IntentText template source with {{variable}} placeholders | | data | object | JSON object with values to substitute into the template | | render | string | "none" (default), "html", or "print" — optionally render the merged result |

validate_document

Validate an IntentText document for se

... View full README on GitHub