Parse, validate, query, and render IntentText (.it) documents for AI agents
Parse, validate, query, and render IntentText (.it) documents for AI agents
A well-structured MCP server for IntentText document processing with clean code architecture, proper error handling, and comprehensive test coverage. The server operates entirely locally without requiring any authentication or external network access, making it very secure for document parsing and rendering operations. Supply chain analysis found 3 known vulnerabilities in dependencies (1 critical, 2 high severity). Package verification found 1 issue.
7 files analyzed · 6 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-intenttext-intenttext-mcp": {
"args": [
"-y",
"@intenttext/mcp-server"
],
"command": "npx"
}
}
}From the project's GitHub README.
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.
npm install -g @intenttext/mcp-server
# or use npx (no install required)
npx @intenttext/mcp-server
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"intenttext": {
"command": "npx",
"args": ["@intenttext/mcp-server"]
}
}
}
{
"command": "npx",
"args": ["@intenttext/mcp-server"],
"env": {}
}
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 endpointGET /health - health check endpointEnvironment 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.
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 an IntentText source string to styled HTML.
| Parameter | Type | Description |
|---|---|---|
source | string | IntentText source string (.it format) |
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 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 an IntentText document for semantic correctness. Checks for broken step references, missing required properties, unresolved variables, and workflow logic errors.
| Parameter | Type | Description |
|---|---|---|
source | string | IntentText source string to validate |
Query an IntentText document for specific blocks by type, content, or properties.
| Parameter | Type | Description |
|---|---|---|
source | string | IntentText source string |
type | string | Block type filter — e.g. "task", "step,gate,decision" |
content | string | Substring to search for in block content |
section | string | Only return blocks within this section |
limit | number | Maximum number of results to return |
Compare two versions of an IntentText document and return a semantic diff.
| Parameter | Type | Description |
|---|---|---|
before | string | The original IntentText source |
after | string | The updated IntentText source |
Convert an IntentText JSON document back to .it source format.
| Parameter | Type | Description |
|---|---|---|
document | object | An IntentText document JSON object (as produced by parse_intent_text) |
Extract the execution graph from an IntentText workflow document. Returns steps in topological order, dependency relationships, parallel batches, and gate positions.
| Parameter | Type | Description |
|---|---|---|
source | string | IntentText source containing workflow blocks (step:, decision:, gate:, etc.) |
User: Create a deployment workflow for a web app
Agent calls: parse_intent_text with a generated .it document
Agent calls: validate_document to check for issues
Agent calls: extract_workflow to get the execution graph
Agent calls: render_html to produce a visual version
MIT
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally