TS-MCP: Touchstone

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

typescript

1

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "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.