home / mcp / ts-mcp: touchstone mcp server

TS-MCP: Touchstone MCP Server

Provides a Touchstone MCP server to run conversational FHIR tests with configurable authentication and test tooling.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aegisnetinc-ts-mcp": {
      "command": "npx",
      "args": [
        "github:AEGISnetInc/TS-MCP"
      ],
      "env": {
        "TOUCHSTONE_BASE_URL": "https://touchstone.aegis.net"
      }
    }
  }
}

This MCP server lets you run Touchstone-based conversational FHIR tests locally, connect from your MCP client, and view test execution status and results. It is designed for ease of use with clear startup and authentication flows so you can quickly run and verify test setups against Touchstone.

How to use

You start the TS-MCP server from your command line and then connect your MCP client to run tests. Use the server to launch test executions, monitor their progress, and retrieve detailed results. Authenticate with Touchstone once to enable secure test runs, then trigger test setups such as Patient-CRUD tests from your MCP client workflow.

How to install

Prerequisites: you need Node.js 18 or newer, the Claude Code CLI installed, and a Touchstone account with a configured Test Setup.

npm --version
node --version
```

Ensure your environment meets the prerequisites before proceeding.

Install and inspect the TS-MCP package to confirm it is usable from your environment.

npx github:AEGISnetInc/TS-MCP --help

Add the MCP server to Claude Code so you can reference it from your Claude workflows.

claude mcp add ts-mcp -- npx github:AEGISnetInc/TS-MCP

Authenticate to enable Touchstone access for test execution.

npx github:AEGISnetInc/TS-MCP auth

Start using the server and run tests from your MCP client workflow. For example, you may trigger a predefined Patient-CRUD test setup.

> Note: Use your Claude Code workflow to invoke the test setup, such as selecting the Patient-CRUD test path from within Claude Code.

Configuration and usage notes

Environment variable for Touchstone API URL can be configured to point to the Touchstone instance you want to test against.

TOUCHSTONE_BASE_URL=https://touchstone.aegis.net

Typical start and usage flow is to run the MCP server and then perform authentication if required, followed by launching test executions from your MCP client.

Updating

To update to the latest version, refresh the package cache and re-run the help command to verify the latest options.

npm cache clean --force
npx github:AEGISnetInc/TS-MCP --help

Available tools

launch_test_execution

Start a test run within the MCP server to execute a configured test setup.

get_test_status

Check the current status of an ongoing test run.

get_test_results

Retrieve detailed results for completed test runs.