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