Specifai MCP Server

by presidio-oss

13 stars
264 downloads
Not rated
GitHub

About

MCP server to provide Specifai project requirements, task, etc. to any AI tools supporting MCP such as Hai Build, Cursor.

Details

Author
presidio-oss
GitHub stars
13
Downloads
264
Categories
Developer Tools, API, Automation, AI

- Read all specification documents generated by Specifai
- Tool‑agnostic – works with any MCP‑compatible AI tool
- Full‑text search across all specification documents
- Supports multiple IDEs: VS Code, Cursor, Windsurf, Zed, Hai Build, Amazon Q Developer
- Optional .specifai-path file for persistent project directory configuration
- Simple JSON configuration via mcpServers block

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Specifai MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install using npx --yes @presidio-dev/specifai-mcp-server@latest and configure your MCP client with the command and arguments. Optionally place a .specifai-path file in your project root containing the absolute path to your Specifai project directory. The server provides tools such as get-brds, get-prds, get-nfrs, get-uirs, get-bpds, get-tcs, get-user-stories, get-tasks, get-task, set-project-path, get-task-by-id, list-all-tasks, and search.

get-brds

Get Business Requirement Documents for this project, returns ID, Title, Description(not included by default)

get-prds

Get Product Requirement Documents for this project, returns ID, Title, Description(not included by default), Ado Id (When PRD/US/Task is linked to ADO), Jira Id (When PRD/US/Task is linked to JIRA), PMO Id(when available), Ado Issue Type(when available), Jira Issue Type(when available), and LinkedBRDIds (when available)

get-nfrs

Get Non-Functional Requirement Documents for this project, returns ID, Title, Description(not included by default)

get-uirs

Get User Interface Requirement Documents for this project

get-bpds

Get Business Process Documents for this project

get-tcs

Get Test Case Documents for this project

get-user-stories

Get User Stories for a particular PRD

get-tasks

Get Tasks for a particular User Story

get-task

Get list of Tasks for a particular User Story in a particular PRD

set-project-path

Update the project path and reload the solution. use this tool only when we not automatically able to infer the project path or asked by the user or us., we will try to auto infer it from the environment first.

get-task-by-id

Retrieves complete information about a specific task when you know its exact ID. This tool provides direct access to a single task's details without having to retrieve and filter through all tasks., returns full task object, ID, Title, Description, Ado Id (When Task is linked to ADO), Jira Id (When Task is linked to JIRA), PMO Id(when available), Ado Issue Type(when available), Jira Issue Type(when available)

list-all-tasks

List all the tasks available across all PRDs and User Stories, without task description, only return ID, Title, Ado Id (When Task is linked to ADO), Jira Id (When Task is linked to JIRA), PMO Id(when available), Ado Issue Type(when available), Jira Issue Type(when available)

search

Search documents by text content or Pmo ID across all documents, returns document ID, Title, Description, Type, Ado Id (When PRD/US/Task is linked to ADO), Jira Id (When PRD/US/Task is linked to JIRA), PMO Id(when available), Ado Issue Type(when available), Jira Issue Type(when available)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "specifai mcp server": {
            "specifai-mcp-server": {
                "command": "npx",
                "args": [
                    "--yes",
                    "@presidio-dev/specifai-mcp-server@latest"
                ]
            }
        }
    }
}

McpServers

{
    "specifai-mcp-server": {
        "command": "npx",
        "args": [
            "--yes",
            "@presidio-dev/specifai-mcp-server@latest"
        ]
    }
}

Specifai MCP Server

License: MIT
npm version
Install in VS Code (npx)
Install in VS Code Insiders (npx)
Install in Cursor (npx)

<p>
Hai Build
Amazon Q
VS Code
Cursor
Windsurf
Zed
</p>

A Model Context Protocol (MCP) server for Specifai project integration and automation with any MCP-compatible AI tool. This server is designed to be tool-agnostic, meaning it can be used with any tool that supports the MCP protocol. This server currently exposes tools to read all documents generated by the Specifai project.

> [!WARNING]
> This server is currently experimental. The functionality and available tools are subject to change and expansion as we continue to develop and improve the server.

Table of Contents

- Requirements
- Installation
- Configuration
- Preparing Your Project
- IDE Integration
- Available Tools
- Contributing
- Security
- License

Requirements

- Node.js >= 16.0.0
- Bun >= 1.0.0 (if using Bun runtime)
- Hai Build, Cursor, Windsurf, Claude Desktop or any MCP Client

Installation

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.