Skip to main content
Glama

EasyRunCraft MCP

EasyRunCraft MCP is the Model Context Protocol broker for EasyRunCraft. Assistants use it to inspect and edit documents, spreadsheets, images, audio, video, and design files. Processing runs on EasyRunCraft native engines and spends the connected account’s EasyRunCraft credits.

Product

https://easyruncraft.com

Setup

https://easyruncraft.com/mcp

Pricing

https://easyruncraft.com/pricing

Registry name

com.easyruncraft/mcp

Transport

Streamable HTTP

Endpoint

https://easyruncraft.com/mcp

Authorization

OAuth, scope mcp:tools (refresh uses offline_access)

This repository contains the broker entry point mcp/server.mjs, the modules it imports, the public MCP guides in docs/, and the registry manifest server.json.

Connect

Add the hosted endpoint to a client that supports MCP Streamable HTTP, then sign in in the browser:

https://easyruncraft.com/mcp

EasyRunCraft discovers OAuth metadata from that resource, shows the account login and consent screen, and issues audience-bound access tokens for mcp:tools. The same endpoint accepts a dedicated bearer token created in the advanced section of https://easyruncraft.com/mcp.

Codex:

codex mcp add easyruncraft --url https://easyruncraft.com/mcp
codex mcp login easyruncraft

mcp.json in this repository is the remote server entry used by agent plugin hosts: Streamable HTTP at the URL above, with OAuth client identity metadata and the mcp:tools and offline_access scopes.

Related MCP server: mcp-office-writer

Run the broker locally

The supported client endpoint is the hosted URL. This package can also start the same broker on your machine. Node.js 22 or newer is required. Account sign-in and credit billing stay on an EasyRunCraft account API. Native editor binaries are separate runtime releases and are supplied through MCP_NATIVE_DIR; they are not stored in this repository.

npm install
export PUBLIC_URL=http://127.0.0.1:4350
export ACCOUNT_API_URL=http://127.0.0.1:8795
export MCP_BILLING_SECRET="$(openssl rand -hex 32)"
npm start

npm start runs node mcp/server.mjs. In development the process listens on 127.0.0.1:8796. PUBLIC_URL and ACCOUNT_API_URL must be loopback addresses. A call to /mcp proceeds after ACCOUNT_API_URL accepts the bearer token at /api/mcp/authenticate.

Variable

Development default

Role

MCP_PORT

8796

Listen port

LISTEN_HOST

127.0.0.1

Listen address

PUBLIC_URL

http://127.0.0.1:4350

Public origin used for OAuth resource metadata and signed file URLs

ACCOUNT_API_URL

http://127.0.0.1:8795

Account API for authentication and billing

MCP_BILLING_SECRET

unset

Shared secret for /api/mcp/billing; required before a task can reserve credits (at least 32 characters)

MCP_DATA_DIR

.data/dev/mcp-files

Private uploads, outputs, and file metadata

MCP_NATIVE_DIR

.cache/native

Installed native editor executables

MCP_WORK_DIR

.cache/mcp-work

Per-job work directories

MCP_CONCURRENCY

2

Running jobs, from 1 to 4

RUNTIME_STORE_DIR

unset

Runtime release store used by the release endpoint

RUNTIME_RELEASE_SECRET

unset

Bearer secret for runtime release publication

NODE_ENV

unset

production selects the Linux production listener, HTTPS origin, and uid-isolated jobs

GET /mcp-health reports whether each native engine is present. File-processing tools need those engines. The hosted service at https://easyruncraft.com/mcp already has them installed.

Tools

service_info, quote_task, create_upload, inspect_file, edit_spreadsheet, pdf_capabilities, query_pdf, edit_pdf, export_pdf, editor_capabilities, process_photo, process_word, process_deck, process_vector, process_fig, process_cad, process_design, process_light, process_sound, process_film, process_effect, get_job, cancel_job, delete_file.

Upload with create_upload, PUT the bytes to the returned URL, then call the tool that matches the format. quote_task returns the price before a job is submitted. Poll get_job for the result. Successful file-processing requests cost 1 credit, including inspections, audio conversion, video export, and animation rendering. Uploads, quotes, capability checks, status polls, and downloads have no separate charge. Plan terms are on https://easyruncraft.com/pricing.

Temporary files expire after 2 hours without activity on that file. Processing, quotes, result retrieval, and downloads renew the idle deadline.

Directory metadata

MCP Market, TrackMCP, and the official MCP Registry can read this repository directly.

  • server.json and distribution/server.json follow the MCP server schema. The server name is com.easyruncraft/mcp. The description is within the registry’s 100-character limit. remotes lists one Streamable HTTP URL: https://easyruncraft.com/mcp.

  • package.json sets mcpName to that same registry name, homepage to https://easyruncraft.com, and the git repository to https://github.com/eastling/easyruncraft-mcp.

  • mcp.json declares the remote server for plugin hosts.

Submit the repository URL https://github.com/eastling/easyruncraft-mcp to MCP Market and TrackMCP. Both listings pull the README, the manifest, and the source from this public repository.

Documentation

Some of those guides link to deployment pins that live with the EasyRunCraft product checkout. The broker source those guides describe is the mcp/ tree in this repository.

License

MIT. See LICENSE. Native editor binaries are not part of this package; their own license notices stay with those runtime releases.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    B
    maintenance
    Enables AI clients to create, inspect, edit, analyze, review, and finalize Word, Excel, and PowerPoint files, with optional native Windows Office automation for full-fidelity editing, calculation, rendering, PDF export, and visual review.
    34
    132 npm
    1
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables generating DOCX and XLSX files and editing attached documents through structured tools over Streamable HTTP, with per-user uploads, downloads, and document operations. It provides authenticated file access and document creation, reading, and modification without requiring Office or LibreOffice.
    Apache 2.0