holaspirit-integration-gateway

An implementation of the MCP (Model Context Protocol) server layer that interfaces directly with the Holaspirit API.

This server abstracts Holaspirit's proprietary data access, offering an MCP-compliant abstraction layer. This standardization enables autonomous agents and advanced computational entities to interact with enterprise data managed by Holaspirit through a unified protocol.

Capabilities Exposed

Functionality modules available:

• holaspirit_list_tasks - Enumerates all pending work items within the organizational structure.
• holaspirit_list_metrics - Retrieves a catalog of all defined performance indicators.
• holaspirit_list_circles - Yields a directory of all operational governance units (circles).
• holaspirit_get_circle - Fetches comprehensive schema for a designated organizational unit.
• holaspirit_list_roles - Provides a listing of all defined functional positions.
• holaspirit_get_role - Acquires granular specifications for a specific functional position.
• holaspirit_list_domains - Presents an inventory of all defined spheres of accountability.
• holaspirit_list_policies - Returns a registry of organizational governing documents.
• holaspirit_list_meetings - Surfaces a record of all scheduled collaborative sessions.
• holaspirit_get_meeting - Retrieves the detailed context for an identified session.
• holaspirit_get_member_feed - Accesses the chronological activity stream for an individual participant.
• holaspirit_get_tensions - Extracts reported points of friction or misalignment across specified meetings.
• holaspirit_search_member - Executes a lookup for a personnel record based on electronic mail address.

Initial Deployment Guide

Acquisition

Integration via Smithery

To provision the holaspirit-integration-gateway onto Claude Desktop automatically using Smithery:

bash npx -y @smithery/cli install holaspirit-mcp-server --client claude

Standalone Acquisition

bash npm install holaspirit-mcp-server

Configuration Parameters

Operational settings are managed via environmental parameters. Two distinct configuration methodologies are supported:

Environmental Variables Specification

• HOLASPIRIT_API_TOKEN: The requisite authentication credential for the Holaspirit service.
• HOLASPIRIT_ORGANIZATION_ID: The unique identifier for the enterprise instance.

Utilization of .env Manifest

Instantiate a .env file in the execution root:

bash

Duplicate the template file

cp .env.example .env

Subsequently, populate the .env file with actual credentials:

bash HOLASPIRIT_API_TOKEN=your_secure_api_token_here HOLASPIRIT_ORGANIZATION_ID=your_corporate_identifier_here

Operational Modes

The gateway supports dual transport paradigms:

Standard I/O Transport (Default Mechanism)

Intended for consumers employing stdin/stdout communication channels compliant with the MCP specification: bash npx holaspirit-mcp-server

HTTP Transport Layer

For integration with web-based consumers or systems utilizing the contemporary Streamable HTTP conduit: bash npx holaspirit-mcp-server --port 3000

The HTTP listener processes POST requests indiscriminately across all endpoints (e.g., /, /mcp, /sse), adhering strictly to the Streamable HTTP transport specification.

Client Configuration Modification

Adjust your client's MCP configuration JSON structure accordingly:

For I/O transport:

... "holaspirit": { "command": "npx", "args": [ "-y", "holaspirit-mcp-server" ], "env": { "HOLASPIRIT_API_TOKEN": "", "HOLASPIRIT_ORGANIZATION_ID": "" } }, ...

For HTTP transport, direct the client endpoint to: - http://localhost:3000/ (Any URI path is accepted)

Development Lifecycle

Available Execution Scripts

• npm run dev - Initiates the server in a development environment featuring live code reloading.
• npm run build - Compiles the source code for deployment in a production setting.
• npm run start - Launches the pre-built production server instance.
• npm run lint - Executes static analysis tools (ESLint and Prettier) for quality assurance.
• npm run fix - Attempts automated remediation of identified code style infractions.
• npm run examples - Runs pre-defined usage demonstration scripts.

Community Participation

1. Create a fork of the repository.
2. Establish a dedicated feature branch for your modifications.
3. Validate code quality via testing and linting: npm run lint
4. Commit your resultant changes.
5. Push the branch to the remote repository.
6. Submit a formal Pull Request.

WIKIPEDIA: Business management tools are all the systems, applications, controls, calculating solutions, methodologies, etc. used by organizations to be able to cope with changing markets, ensure a competitive position in them and improve business performance.

== Overview == There are tools related to each organization's department which can be classified for each aspect of management. For example: planning tools, process tools, records tools, employee related tools, decision making tools, control tools, etc. A classification by function would consider these general aspects:

Tools used for data input and validation in any department. Tools used for controlling and improving business processes. Tools used for data consolidation and decision making. Nowadays, management tools have evolved dramatically in the last decade thanks to fast technology advances, so fast that it is difficult to select the best business tools for any situation in any company. This is caused by a never-ending fight for lower costs and increase sales, the willingness for understanding the customers' needs, and the fight for delivering the products that meet their need in the way they require. Under this scenario, managers should take a strategic attitude to business management tools instead of going for the latest tool. Usually, managers rely on the tools without any adaptation which leads to an unstable situation. Business management tools should be selected carefully, and then adapted to the organization needs and not the other way around.

== Most used == In 2013, a survey conducted by Bain & Company showed how business tools are used around the globe. These tools reflect how their outcomes contribute to each region's needs, considering the downfall and companies' market situation. The top ten includes:

Strategic planning Customer relationship management Employee engagement surveys Benchmarking Balanced scorecard Core competency Outsourcing Change management programs Supply chain management Mission statement and vision statement Market segmentation Total quality management

== Software application for businesses == Software or collection of computer programs used by business users to carry out various business operations is referred to as business software (or a business application). These business applications are used to boost output, gauge output, and carry out various other company tasks precisely. It started with management information systems and extended into enterprise resource planning systems. Then customer relationship management was added to the solution and finally the whole package moved into the cloud business management space. Although there is an actual correlation between IT efforts and the organizations' performance, two elements are key to add value to the sum; these are the implementation's effectiveness and the proper tools selections and adaptation process.

== Tools for SMEs == The tools focused on SMEs are important because they provide ways to save m