Arcanna MCP Server

Arcanna MCP Server

The Arcanna MCP server allows user to interact with Arcanna's AI use cases through the Model Context Protocol (MCP).

Usage with Claude Desktop or other MCP Clients

Configuration

Add the following entry to the mcpServers section in your MCP client config file (claude_desktop_config.json for Claude Desktop).

Use docker image (https://hub.docker.com/r/arcanna/arcanna-mcp-server) or PyPi package (https://pypi.org/project/arcanna-mcp-server/)

Building local image from this repository

Prerequisites

• Docker - https://docs.docker.com/engine/install/

Configuration

1. Change directory to the directory where the Dockerfile is.
2. Run docker build -t arcanna/arcanna-mcp-server . --progress=plain --no-cache
3. Add the configuration bellow to your claude desktop/mcp client config.

{
  "mcpServers": {
    "arcanna-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ARCANNA_MANAGEMENT_API_KEY",
        "-e",
        "ARCANNA_HOST",
        "arcanna/arcanna-mcp-server"
      ],
      "env": {
        "ARCANNA_MANAGEMENT_API_KEY": "<ARCANNA_MANAGEMENT_API_KEY>",
        "ARCANNA_HOST": "<YOUR_ARCANNA_HOST_HERE>"
      }
    }
  }
}

Features

• Resource Management: Create, update and retrieve Arcanna resources (jobs, integrations)
• Python Coding: Code generation, execution and saving the code block as an Arcanna integration
• Query Arcanna events: Query events processed by Arcanna
• Job Management: Create, retrieve, start, stop, and train jobs
• Feedback System: Provide feedback on decisions to improve model accuracy
• Health Monitoring: Check server and API key status

Tools

Query Arcanna events

• query_arcanna_events

  • Used to get events processed by Arcanna, multiple filters can be provided

• get_filter_fields

  • used as a helper tool (retrieve Arcanna possible fields to apply filters on)

Resource Management

• upsert_resources

  • Create/update Arcanna resources

• get_resources

  • Retrieve Arcanna resources (jobs/integrations)

• delete_resources

  • Delete Arcanna resources

• integration_parameters_schema

  • used in this context as a helper tool

Python Coding

• generate_code_agent

  • Used to generate code

• execute_code

  • Used to execute the generated code

• save_code

  • Use to save the code block in Arcanna pipeline as an integration

Job Management

• start_job

  • Begin event ingestion for a job

• stop_job

  • Stop event ingestion for a job

• train_job

  • Train the job's AI model using the provided feedback

Feedback System

• add_feedback_to_event
  • Provide feedback on AI decisions for model improvement

System Health

• health_check
  • Verify server status and Management API key validity
  • Returns Management API key authorization status