Get started with the MCP Server

The Python SDK includes an MCP (Model Context Protocol) server that exposes SDK functionality to AI agents like Claude. This lets an AI assistant help you interact with the Aignostics Platform through natural conversation — managing datasets, submitting runs, and querying results.

Sign up for the Aignostics Platform

Before you can run an analysis, you need an account on the Aignostics Platform. These account steps are the same whichever interface you use.

💡 Already have an account? Skip to the installation steps below.

1. Find your invitation email. Look in your inbox for a message from support@aignostics.com, with a subject like “You’ve been invited to join your organization’s Aignostics account”. If you can’t find it, check your spam folder. If it isn’t there either, ask your organization’s administrator or email support@aignostics.com.

2. Accept the invitation. Open the email and click Accept Invitation. A page opens in your browser where you enter your full name and set a password.

3. Set up two-factor authentication. Next, you are asked to set up two-factor authentication. This is a second login step that uses a code from your phone. Install one of these free authenticator apps, then scan the code shown in your browser and enter the six-digit code it gives you:

   • Android: Google Authenticator

   • iPhone: Google Authenticator

   You are done when you see “Welcome to the Console of the Aignostics Platform”. From now on, each time you log in you enter your password and then a fresh six-digit code from the app.

Configure Claude Desktop

The MCP server runs through uv. Install uv first if you don’t have it. The command below installs uv if needed, updates it if out of date (including Homebrew-managed installs), and makes it available in your current shell.

On macOS or Linux:

if ! command -v uv &> /dev/null; then
    echo "uv not found, installing..."
    curl -LsSf https://astral.sh/uv/install.sh | sh
    source $HOME/.local/bin/env
else
    UV_VERSION=$(uv --version | cut -d' ' -f2)
    if [ "$(printf '%s\n' "0.6.17" "$UV_VERSION" | sort -V | head -n1)" != "0.6.17" ]; then
        echo "Updating uv to the latest version..."
        UV_PATH=$(which uv)
        if [[ "$UV_PATH" == *"brew"* ]]; then
            echo "Updating uv using Homebrew..."
            brew upgrade uv
        else
            echo "Updating uv using the installer..."
            uv self update
        fi
    else
        echo "uv is up to date"
    fi
fi

On Windows (PowerShell):

winget install --id=Microsoft.VCRedist.2015+.x64 -e
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Then add the following to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "aignostics": {
      "command": "uvx",
      "args": ["aignostics", "mcp", "run"]
    }
  }
}

Restart Claude Desktop after saving the configuration.

Run the server from the command line

uvx aignostics mcp run
uvx aignostics mcp list-tools

Using plugins

The MCP server supports plugins that extend it with additional tools. To run the server with a plugin installed:

# with a local plugin
uv run --with /path/to/plugin aignostics mcp run

# with a plugin from a git repository
uvx --with git+ssh://git@github.com/org/plugin aignostics mcp run

Plugins register themselves via Python entry points; their tools are automatically discovered and namespaced by the MCP server.

What AI agents can do

Once configured, AI agents can help with platform operations through natural language, using the tools exposed by the SDK and any installed plugins.

Invite your team

If you are your organization’s Administrator, you can invite colleagues onto the Aignostics Platform so they can run analyses too.

💡 Not an administrator? Skip this section — ask whoever set up your organization’s account to invite you.

1. Open the members page. Log in to the Aignostics Console, select Admin in the sidebar, then open Members.

2. Add a colleague and choose their role. At the bottom of the Members page, enter their email address and assign a role:

   • Member — can run applications and manage their own runs.

   • Admin — everything a member can do, plus inviting and managing other users.

   ⚠️ The email address must use your organization’s own domain — the same domain as yours.

3. Send the invitation. Click Send. Your colleague receives a signup email from support@aignostics.com and completes the same signup steps you did — accepting the invitation, setting a password, and configuring two-factor authentication.

Return to the Members page any time to review your organization’s users and their roles.