mmt-mcp 1.42.2-pre

package/README.md

@@ -0,0 +1,22 @@
+# mmt-mcp
+
+MCP server for [Multimeter](https://mmt.dev): Git-native API testing in VS Code.
+
+Multimeter is an AI-powered REST Client and API testing tool. It is not an electrical multimeter. Tests are YAML `.mmt` files. This server lets Cursor, GitHub Copilot, and Claude **scaffold, validate, format, and run** those files. The model writes YAML. Do not invent `.mmt` syntax.
+
+```json
+{
+  "mcpServers": {
+    "multimeter": {
+      "command": "npx",
+      "args": ["-y", "mmt-mcp"]
+    }
+  }
+}
+```
+
+First tools: `scaffold_test`, `validate`, `format`, `run`.
+
+- Docs: https://mmt.dev/docs/features/mcp
+- Agents: https://mmt.dev/for-agents.html
+- llms.txt: https://mmt.dev/llms.txt

package/dist/examples/README.md

@@ -0,0 +1,19 @@
+# Multimeter Examples
+
+The examples are grouped by complexity so new users can start simple and add power only when they need it.
+
+## Basic
+
+- `basic/01_simple_api` - run one simple GET API and simple POST APIs.
+- `basic/02_simple_test` - write a direct HTTP test without inputs, outputs, imports, or API abstraction.
+- `basic/03_environment_variables` - use a plain environment variable without presets.
+- `basic/04_basic_suite` - run a small suite of simple HTTP tests.
+- `basic/05_basic_documentation` - render simple input/output parameter documentation.
+
+## Intermediate
+
+Use these when you are ready for reusable APIs, authentication, mock servers, richer environment variables, inputs and outputs, suites, imports, data-driven tests, environment presets, documentation options/ranges, control flow, comparison operators (`expect` / `check` / `assert`), helper JavaScript, additional protocol or file formats, converting a small OpenAPI / Postman / WSDL / HTTP / Bruno file to `.mmt`, and the `omit` keyword.
+
+## Professional
+
+Use these for higher-complexity workflows such as reports, CI pipelines (GitHub, GitLab, Azure), TLS/mTLS certificates, load testing, external mTLS smoke tests, converting a full OpenAPI spec (operations, examples, auth, schemas) into `.mmt` files, and advanced JavaScript helper imports.

package/dist/examples/ai/golden_smoke/README.md

@@ -0,0 +1,8 @@
+# Golden smoke (AI)
+
+Tiny API + scaffolded test used as the default Multimeter few-shot for agents.
+
+- `apis/echo.mmt` — source API
+- `tests/echo-smoke.mmt` — must match `scaffold_test` output
+
+See `docs/AI/golden-smoke.md`.

package/dist/examples/ai/golden_smoke/apis/echo.mmt

@@ -0,0 +1,12 @@
+type: api
+title: Echo message
+description: Golden smoke API for AI agents — minimal POST with outputs
+inputs:
+  message: hello
+outputs:
+  echoed: body.message
+url: https://test.mmt.dev/echo
+method: post
+format: json
+body:
+  message: i:message

package/dist/examples/ai/golden_smoke/tests/echo-smoke.mmt

@@ -0,0 +1,18 @@
+type: test
+title: Echo message smoke test
+description: Smoke test for API "Echo message".
+tags:
+  - smoke
+  - post
+import:
+  echo: ../apis/echo.mmt
+inputs:
+  message: i:message
+steps:
+  - call: echo
+    id: iEcho
+    inputs:
+      message: i:message
+    expect:
+      status: 200
+      echoed: != null

package/dist/examples/basic/01_simple_api/README.md

@@ -0,0 +1,38 @@
+# Simple API
+
+Basic `type: api` examples using one GET request and simple POST requests against the [test.mmt.dev](https://test.mmt.dev) public test server.
+
+## Files
+
+| File | Description |
+|---|---|
+| `get_json.mmt` | Simple GET request that returns a sample JSON payload |
+| `post_echo_yaml_body.mmt` | Simple POST request with a YAML object body, serialized to JSON |
+| `post_echo_json_body.mmt` | Simple POST request with a raw JSON body |
+
+## How to use
+
+### In VS Code
+
+1. Open any `.mmt` file in this folder.
+2. Click **Run** in the editor to execute the API call.
+3. View the response in the output panel.
+
+### With the CLI
+
+```sh
+npx testlight run examples/basic/01_simple_api/get_json.mmt
+npx testlight run examples/basic/01_simple_api/post_echo_yaml_body.mmt
+npx testlight run examples/basic/01_simple_api/post_echo_json_body.mmt
+```
+
+## What these hit
+
+All requests go to `https://test.mmt.dev`, a public HTTP test server with endpoints for status codes, delays, echo, auth, and more.
+
+## Next steps
+
+- See [Simple Test](../02_simple_test/) for a direct HTTP test.
+- See [Environment Variables](../03_environment_variables/) for using variables without editing API files.
+- See [API Authentication](../../intermediate/17_api_authentication/) for Basic, Bearer, and API key auth examples.
+- See [API docs](../../../docs/files/api/index.md) for the full `.mmt` API reference.

package/dist/examples/basic/01_simple_api/get_json.mmt

@@ -0,0 +1,6 @@
+type: api
+title: Get sample JSON
+description: Returns a fixed JSON payload from the test server
+url: https://test.mmt.dev/json
+method: get
+format: json

package/dist/examples/basic/01_simple_api/post_echo_json_body.mmt

@@ -0,0 +1,13 @@
+type: api
+title: Post echo JSON body
+description: Sends a raw JSON body and gets it echoed back
+url: https://test.mmt.dev/echo
+method: post
+format: json
+headers:
+  Content-Type: application/json
+body: |-
+  {
+    "name": "Multimeter",
+    "message": "Hello from JSON!"
+  }

package/dist/examples/basic/01_simple_api/post_echo_yaml_body.mmt

@@ -0,0 +1,11 @@
+type: api
+title: Post echo
+description: Sends a JSON body and gets it echoed back
+url: https://test.mmt.dev/echo
+method: post
+format: json
+headers:
+  X-Custom: multimeter-example
+body:
+  name: Multimeter
+  message: Hello from mmt!

package/dist/examples/basic/02_simple_test/README.md

@@ -0,0 +1,35 @@
+# Simple Test
+
+A minimal `type: test` file that calls HTTP directly and checks the response. It avoids inputs, outputs, imports, and API abstraction so the first test example stays easy to read.
+
+## Files
+
+| File | Description |
+|---|---|
+| `echo_test.mmt` | Sends a POST request to the public echo endpoint and verifies the response |
+
+## How to use
+
+### In VS Code
+
+1. Open `echo_test.mmt`.
+2. Click **Run** to execute the test.
+3. The Log panel shows whether the check passed or failed.
+
+### With the CLI
+
+```sh
+npx testlight run examples/basic/02_simple_test/echo_test.mmt
+```
+
+## Key concepts
+
+- **`type: test`** declares a runnable test flow.
+- **`http`** calls an endpoint directly from a test step.
+- **`expect`** checks response fields and reports failures.
+
+## Next steps
+
+- See [Simple API](../01_simple_api/) for standalone API files.
+- See [API Inputs & Outputs](../../intermediate/01_api_inputs_outputs/) when you are ready for inputs, outputs, and reusable API definitions.
+- See [Test docs](../../../docs/files/test/index.md) for the full test reference.

package/dist/examples/basic/02_simple_test/echo_test.mmt

@@ -0,0 +1,12 @@
+type: test
+title: Simple HTTP test
+description: Calls an HTTP endpoint directly and checks the response
+steps:
+  - http: https://test.mmt.dev/echo
+    title: Send an echo request
+    method: post
+    body:
+      message: hello world
+    expect:
+      status: 200
+      body.body.message: hello world

package/dist/examples/basic/03_environment_variables/README.md

@@ -0,0 +1,40 @@
+# Environment Variables
+
+A simple environment file with one plain variable. There are no presets in this basic example.
+
+## Files
+
+| File | Description |
+|---|---|
+| `multimeter.mmt` | Defines the `base_url` variable |
+| `get_json.mmt` | GET request using `<<e:base_url>>/json` |
+
+## How to use
+
+### In VS Code
+
+1. Open the Environment panel and load `multimeter.mmt`.
+2. Open `get_json.mmt`.
+3. Click **Run**.
+
+### With the CLI
+
+```sh
+npx testlight run examples/basic/03_environment_variables/get_json.mmt \
+  --env-file examples/basic/03_environment_variables/multimeter.mmt
+```
+
+Override the variable directly:
+
+```sh
+npx testlight run examples/basic/03_environment_variables/get_json.mmt \
+  -e base_url=https://test.mmt.dev
+```
+
+## Key concepts
+
+- **`<<e:var>>`** embeds an environment variable inside a string.
+- POST requests with env headers are covered later in [Environment POST Echo](../../intermediate/19_environment_post_echo/).
+- Presets are covered later in [Environment Presets](../../intermediate/10_environment_presets/).
+
+See [Environment docs](../../../docs/files/env/index.md) for full details.

package/dist/examples/basic/03_environment_variables/get_json.mmt

@@ -0,0 +1,6 @@
+type: api
+title: Get sample JSON
+description: Fetch a sample JSON payload using an environment-based URL
+url: <<e:base_url>>/json
+method: get
+format: json

package/dist/examples/basic/03_environment_variables/multimeter.mmt

@@ -0,0 +1,3 @@
+type: env
+variables:
+  base_url: https://test.mmt.dev

package/dist/examples/basic/04_basic_suite/README.md

@@ -0,0 +1,33 @@
+# Basic Suite
+
+A minimal `type: suite` example that runs two simple HTTP tests together.
+
+## Files
+
+| File | Description |
+|---|---|
+| `suite.mmt` | Lists the tests to run |
+| `tests/get_status_test.mmt` | Simple GET test |
+| `tests/post_echo_test.mmt` | Simple POST test |
+
+## How to use
+
+### In VS Code
+
+1. Open `suite.mmt`.
+2. Click **Run** to execute both tests.
+3. The suite report shows each test result.
+
+### With the CLI
+
+```sh
+npx testlight run examples/basic/04_basic_suite/suite.mmt
+```
+
+## Key concepts
+
+- **`type: suite`** groups test files.
+- **`items`** lists the files to run (tests, APIs, or other suites).
+- Suites are useful when a workflow grows beyond one test file.
+
+See [Suite docs](../../../docs/files/suite/index.md) for the full suite reference.

package/dist/examples/basic/04_basic_suite/suite.mmt

@@ -0,0 +1,6 @@
+type: suite
+title: Basic Suite
+description: Runs two simple HTTP tests together
+items:
+  - tests/get_status_test.mmt
+  - tests/post_echo_test.mmt

package/dist/examples/basic/04_basic_suite/tests/get_status_test.mmt

@@ -0,0 +1,9 @@
+type: test
+title: Basic GET test
+description: Calls a simple endpoint and checks the HTTP status
+steps:
+  - http: https://test.mmt.dev/json
+    title: Get JSON
+    method: get
+    expect:
+      status: 200

package/dist/examples/basic/04_basic_suite/tests/post_echo_test.mmt

@@ -0,0 +1,12 @@
+type: test
+title: Basic POST test
+description: Sends a simple POST body and checks the echoed response
+steps:
+  - http: https://test.mmt.dev/echo
+    title: Post echo
+    method: post
+    body:
+      message: hello suite
+    expect:
+      status: 200
+      body.body.message: hello suite

package/dist/examples/basic/05_basic_documentation/README.md

@@ -0,0 +1,24 @@
+# Basic Documentation
+
+A minimal `type: doc` example that shows how parameter annotations are rendered. The doc file has no description so the sample focuses only on the API and its parameters.
+
+## Files
+
+| File | Description |
+|---|---|
+| `document.mmt` | Renders documentation for the API files in `api/` |
+| `api/get_user.mmt` | API with simple input and output parameter annotations |
+
+## How to use
+
+1. Open `document.mmt` in VS Code with the Multimeter extension.
+2. The editor renders the documented API.
+3. Expand the API row to see the input and output parameter descriptions.
+
+## Key concepts
+
+- **`type: doc`** scans API files and renders documentation.
+- **`<<i:param>>`** documents an input parameter.
+- **`<<o:param>>`** documents an output parameter.
+
+See [Doc docs](../../../docs/files/doc/index.md) for the full reference.

package/dist/examples/basic/05_basic_documentation/api/get_user.mmt

@@ -0,0 +1,12 @@
+type: api
+title: Get user
+description: |-
+  <<i:user_id>> User ID to fetch
+  <<o:name>> User display name
+inputs:
+  user_id: 1
+outputs:
+  name: body.name
+url: https://test.mmt.dev/json
+method: get
+format: json

package/dist/examples/basic/05_basic_documentation/document.mmt

@@ -0,0 +1,4 @@
+type: doc
+title: Basic Parameter Docs
+sources:
+  - api