home / mcp / sond core api mcp server

Sond Core API MCP Server

MCP Server generated by mcp.ag2.ai

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "amirlazarovich-git-sond-core-api": {
      "url": "https://core-api-lb.sond.com/api-json",
      "headers": {
        "CONFIG": "{\"openapiUrl\":\"https://core-api-lb.sond.com/api-json\"}",
        "SECURITY": "YOUR_API_KEY",
        "CONFIG_PATH": "PATH_TO_CONFIG_JSON"
      }
    }
  }
}

You run an MCP server that hosts a client-facing interface over a specified OpenAPI URL, enabling you to query data and invoke actions through MCP-compatible clients. This server is designed to automatically expose endpoints based on the provided API definition, making integration straightforward and consistent across your applications.

How to use

You interact with the MCP server from an MCP client. The server provides a standard, protocol-based interface to access the underlying OpenAPI-defined data and operations. Use a client that understands MCP transport modes (such as stdio or HTTP-based transport) to connect, issue requests, and receive structured responses. Authentication and configuration are driven by environment variables and runtime arguments as described in the installation and configuration sections.

How to install

Prerequisites you need before installing the MCP server are Python 3.9 or newer, and the tools pip and uv installed on your system.

Step 1: Clone the project repository and navigate into the project directory.

Step 2: Install development dependencies.

pip install -e ".[dev]"

If you prefer using uv to install in editable mode, run this alternative.

uv pip install --editable ".[dev]"

Step 3: Run the MCP server in stdio mode.

python mcp_server/main.py stdio

Additional configuration and notes

Configure the server using environment variables to tailor its behavior. You can specify the path to a JSON configuration file or pass a JSON string directly, and you can provide security-related parameters such as API keys as environment variables.

Common environment variables include:

- CONFIG_PATH: Path to a JSON configuration file, e.g., mcp_server/mcp_config.json

- CONFIG: A JSON string containing the configuration

- SECURITY: Environment variables for security parameters (e.g., API keys)

Troubleshooting and tips

If you encounter issues, run static analysis and tests to verify your environment and code quality. The project uses linting, static typing, and tests to help ensure correctness.

Available tools

ruff

Lints and formats the codebase to enforce style and quality standards.

mypy

Performs static type checking to catch type errors before runtime.

pytest

Runs tests to verify functionality and maintain reliability.

hatch

Builds and publishes the project, handling versioning and distribution.

pre-commit

Runs a suite of hooks before each commit to catch issues early.