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