Skip to main content
Glama
mayank2012

Actionstep MCP Server

by mayank2012
README.md
# Actionstep MCP Server

This project is a starter TypeScript implementation of an MCP server for Actionstep-style conveyancing automation. It exposes a small set of example tools and includes a simple HTTP health endpoint for local testing.

## Project overview

The current implementation provides:
- A basic Express HTTP server
- A health check endpoint at `/health`
- An MCP server with two example tools:
  - `ping`
  - `list_conveyancing_actions`

## Tech stack

- TypeScript
- Node.js
- Express
- Model Context Protocol SDK
- Zod
- dotenv

## Folder structure

- `src/` – application source code
- `dist/` – compiled JavaScript output
- `package.json` – scripts and dependencies
- `tsconfig.json` – TypeScript compiler configuration

## Installation

From the project root, install dependencies:

```bash
npm install
```

## Build

Compile the TypeScript source:

```bash
npm run build
```

## Run

Start the server:

```bash
npm start
```

Or run the build and start flow directly:

```bash
npm run dev
```

## Health check

Once running, the server responds at:

```bash
http://localhost:3000/health
```

## Next steps

This starter project is intended as a foundation for a production-ready Actionstep MCP server. Suggested next steps include:
- Connecting the tools to the real Actionstep API
- Adding OAuth 2.0 authentication and token refresh
- Expanding the tool registry for matters, documents, tasks, and settlement workflows
- Adding secure secret storage and audit logging
# Node.js_MCP_Server_Development

TDQS

B3.2/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have completely distinct purposes: one lists conveyancing actions, the other is a health check. There is no overlap or confusion.

Naming Consistency3/5

'list_conveyancing_actions' follows a descriptive verb_noun pattern, but 'ping' uses a different single-verb style. While acceptable, the inconsistency prevents a higher score.

Tool Count2/5

With only 2 tools, the server feels extremely minimal for a system named 'Actionstep'. Most servers in this domain would require more tools to be useful.

Completeness2/5

Only a listing operation and a health check are provided. No creation, modification, deletion, or execution of actions, which are essential for a conveyancing tool.

Maintenance

ActivityStale
ResponsivenessNo issues