Welcome to the everii Model Context Protocol (MCP) Server

This MCP server provides tool access to multiple everii products through a single /mcp endpoint.

Use /health to check server status.

Supported Products

1. PROAD

Provider header: x-mcp-provider: proad

Required headers:

• x-proad-base-url (for example, https://legacy.proadsoftware.com/proad-api/v5)
• x-proad-api-key

Domain extraction: first path segment (for example, /activities -> activities).

2. HelloHQ

Provider header: x-mcp-provider: hellohq

Required headers:

• x-hellohq-api-key

Base URL: fixed to https://api.hellohq.io (no base URL header required).

Domain extraction: second path segment (for example, /v2/Absences -> absences).

3. DNP

Provider header: x-mcp-provider: dnp

Required headers:

• x-dnp-basic-auth (either Basic <base64-token> or raw username:api-key)

Base URL: fixed to https://api.dealsandprojects.com (no base URL header required).

Domain extraction: second path segment (for example, /api/Contact -> contact).

MCP Client Configuration Example

{
  "mcpServers": {
    "PROAD-MCP": {
      "type": "streamable-http",
      "url": "https://mcp-server.example.com/mcp",
      "note": "everii MCP for PROAD",
      "headers": {
        "x-mcp-provider": "proad",
        "x-proad-base-url": "https://your_proad_api_base_url_here",
        "x-proad-api-key": "your_proad_api_key_here"
      }
    },
    "HELLOHQ-MCP": {
      "type": "streamable-http",
      "url": "https://mcp-server.example.com/mcp",
      "note": "everii MCP for HelloHQ",
      "headers": {
        "x-mcp-provider": "hellohq",
        "x-hellohq-api-key": "your_hellohq_api_key_here"
      }
    },
    "DNP-MCP": {
      "type": "streamable-http",
      "url": "https://mcp-server.example.com/mcp",
      "note": "everii MCP for DNP",
      "headers": {
        "x-mcp-provider": "dnp",
        "x-dnp-basic-auth": "your_dnp_basic_auth_or_username_colon_api_key"
      }
    }
  }
}
    

Tool Call Examples

After connecting an MCP client, a common flow is:

1. Call list_domains
2. Call get_read_tool_manifest or get_write_tool_manifest
3. Call get_domain_data, create_domain_data, or update_domain_data

Example request payload: list domains for DNP.

{
  "method": "tools/call",
  "params": {
    "name": "list_domains",
    "arguments": {}
  }
}
  

Example request payload: read contact data from DNP.

{
  "method": "tools/call",
  "params": {
    "name": "get_domain_data",
    "arguments": {
      "domain": "Contact",
      "endpointTemplate": "/api/Contact",
      "queryString": "Skip=0&Take=20"
    }
  }
}