SSyncDev

md-business MCP Server

Keeps invoices, test specs and design docs as schema-checked Markdown and TSV that an AI agent can edit and commit locally.

Local server

What is the md-business MCP Server?

An invoice in a Word file is easy for a person to read and awkward for an agent to change safely. md-business inverts that. Documents live as Markdown with YAML frontmatter, each one declares a JSON Schema, Git keeps the history, and viewers turn the result into A4 PDF or a browser preview for whoever needs to approve it. The md-business MCP server is how an AI agent operates on those files.

Document types it understands

Type Schema
Invoice, quote, receipt invoice/v1
Test specification test-spec/v1 (and test-spec-tsv/v1 for sheets)
Design document spec/v1
API specification api-spec/v1
Database design db-spec/v1, nosql-db-spec/v1
Investigation report investigation/v1

The invoice templates lean towards Japanese requirements, including qualified-invoice registration numbers and mixed 10% and 8% tax rates, with an English baseline as well. All templates use invented data.

How an agent connects

The server runs inside the desktop app for Windows or macOS and starts when the app launches. Open a folder, go to the MCP tab, and either write a .mcp.json into the folder, which Claude Code picks up automatically, or copy a ready-made client entry. The entry is a local HTTP URL with a port and a bearer token; both persist across restarts. In a Git repository the app adds .mcp.json to .gitignore, because the token is a credential. A standalone server without the app also exists.

What the tools allow

  • Read, validate, create, update and search documents, with every call checked against the declared schema and listed in the app
  • Fill TSV test sheets row by row, so untouched rows stay out of the diff
  • Run git_status, git_diff and git_commit in a repository. There is deliberately no push
  • Read external JSON, XML and HAR files without modifying them, and search large logs line by line with tokens, cookies and email addresses masked
  • Edit a folder declared as a website and watch the preview update live
  • Open a document in the app, capture its window, or bring up the print dialog for a finished PDF

Limits

The md-business MCP server reaches no further than the folder open in the app, and the server listens on loopback only. It never receives API keys. Some channels, such as a PWA and a GitHub Action, are still planned, and database design schemas have no blank template yet.

If your agent also needs plain repository access, pair it with Git or Filesystem, or browse other developer tools.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
about_md_businessExplains what can be done in the open folder and which tools to call, in order, for each task.
list_schemasLists the document schemas available.
get_schemaReturns a document schema.
read_documentReads a business document.
validate_documentValidates a document against its declared schema.
create_documentCreates a new document, validated against its schema.
update_documentUpdates an existing document, validated against its schema.
search_documentsSearches Markdown documents and TSV test sheets in the open folder.
read_tsvReads a tab-separated test sheet.
append_tsv_rowAppends a row to a test sheet.
update_tsv_rowUpdates one row of a test sheet, leaving other rows out of the diff.
check_tsvChecks a test sheet without reading it row by row.
git_statusShows git status for the open folder.
git_diffShows the diff of the agent's changes.
git_commitCommits changes. There is no push tool.
read_dataReads external JSON or XML as a tree, read-only.
data_to_tableQuotes a repeating part of JSON or XML data as a table.
read_harReads a HAR network capture.
search_linesFinds matching lines in a log file; results are masked for tokens, cookies and email addresses.
read_linesReads the lines around a hit in a log file.
filter_recordsFilters JSONL or TSV records.
aggregateAggregates JSONL or TSV records.
build_timelineMerges several files into one time-ordered timeline.
save_evidenceSaves an extract as a file an investigation report can cite.
declare_web_modeDeclares the folder a website for site-file editing.
web_mode_statusReports website mode status.
list_site_filesLists the website's files.
read_site_fileReads a website file.
write_site_fileWrites a website file, shown live in the app.
open_in_appOpens a document in the desktop app.
list_open_documentsLists the documents open in the app.
close_documentCloses an open document tab.
export_pdfOpens a document and brings up the print dialog for A4 PDF.
capture_windowCaptures an image of the app's own window.

How to install the md-business MCP Server

{
  "mcpServers": {
    "md-business": {
      "type": "http",
      "url": "http://127.0.0.1:<PORT>/md-business",
      "headers": {
        "Authorization": "Bearer <TOKEN>"
      }
    }
  }
}

In the md-business desktop app, open the folder and use MCP tab > Add settings to the open folder; Claude Code reads the resulting .mcp.json automatically. <PORT> and <TOKEN> are filled in by the app.

Frequently asked questions

The built-in MCP server runs inside the md-business desktop app and starts when it launches. A standalone server package is also available for running without the app.