ThreatMinder · MAGGIE AI

MAGGIE AI Developer

Meet MAGGIE · ThreatMinder AI

Ship MAGGIE into your client's workflow.

MAGGIE is the ThreatMinder AI agent. Pick an integration surface — direct entity search, MCP for tool-driven clients, or Batch API for CSV operations — and move from first call to working rollout with live examples.

base URL

3 integration surfaces Examples included Production URL visible
Open integration studio Visit threatminder.ai
Copilots and agents CSV processing Async batch pipeline

Quick examples

Switch surfaces and inspect the first call.

MCP

Tool-first clients

X-API-Key JSON-RPC Session or stateless
01 Initialize
02 List tools
03 Create batch
POST /api/v2/mcp 
curl -X POST "__PRODUCTION_URL__/api/v2/mcp" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_batch","arguments":{"entityType":"PERSON","useCase":"SEAD4","csvContent":"first_name,last_name,city,state\\nJane,Doe,Austin,TX"}}}'
Return a batch UUID, then fetch the processed result through the same MCP surface.

Batch API

CSV-driven operations

X-API-Key multipart upload UUID polling
01 Upload CSV
02 Store UUID
03 Poll result
POST /api/v2/batch 
curl -X POST "__PRODUCTION_URL__/api/v2/batch" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@customers.csv" \
  -F "name=customer-rollout"
Best for operational teams moving CSV payloads through a predictable async contract.

Integration Studio

Work inside the surface you are actually implementing.

The primary tabs switch between product surfaces. The nested tabs switch between workflow, examples, and operational reference. That keeps the first screen compact while still putting real payloads one click away.

Step 01

Initialize or go stateless.

Open a stateful session when your client maintains context. Use a single POST when each call is independent.

Step 02

List tools dynamically.

Call tools/list to inspect the current runtime schemas before your client issues tool calls.

Step 03

Create the batch, then retrieve the result.

The current tool set exposes create_batch and get_batch_result so job creation and retrieval stay explicit.

POST /api/v2/mcp 
curl -X POST "__PRODUCTION_URL__/api/v2/mcp" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "clientInfo": { "name": "your-client", "version": "1.0.0" },
      "capabilities": {}
    }
  }'
POST tools/list 
curl -X POST "__PRODUCTION_URL__/api/v2/mcp" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list",
    "params": {}
  }'
POST tools/call 
curl -X POST "__PRODUCTION_URL__/api/v2/mcp" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "create_batch",
      "arguments": {
        "entityType": "BUSINESS",
        "useCase": "RESTAURANT-ONBOARD",
        "csvContent": "name,address,city,state,zip\nTaco Palace,123 Main St,Austin,TX,78701"
      }
    }
  }'

Available tools

create_batch

Accepts entityType, useCase, and csvContent. Returns the batch identity.

Available tools

get_batch_result

Accepts a UUID id and returns the processed CSV when the result is ready.

Step 01

Choose entity type and use case.

Batch validation depends on both, so map your source schema before upload.

Step 02

Upload the file and persist the UUID.

Treat the response ID as your job identity for retries, polling, and audit state inside your own system.

Step 03

Poll until the processed CSV is ready.

When the result exists, ThreatMinder returns CSV content containing the enriched output.

PERSON template

first_name,last_name,address,city,state,zip,phone1,email,dob,external_id
Jane,Doe,123 Main St,Austin,TX,78701,5125550199,jane@example.com,1989-08-03,person-001

BUSINESS template

name,address,city,state,zip,phone1,email,external_id
Taco Palace,123 Main St,Austin,TX,78701,5125550148,ops@tacopalace.com,business-001
POST /api/v2/batch 
curl -X POST "__PRODUCTION_URL__/api/v2/batch" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "entityType=PERSON" \
  -F "useCase=SEAD4" \
  -F "file=@./people.csv;type=text/csv"
GET /api/v2/batch/:id 
curl "__PRODUCTION_URL__/api/v2/batch/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-API-Key: YOUR_API_KEY"
201 Created 
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "entityType": "PERSON",
  "useCase": "SEAD4"
}

Supported use cases

One stable key, versioned scoring behind it.

MAGGIE supports people, business, AML, supply-chain, executive protection, and monitoring workflows. The full use-case catalog now lives on its own page so implementation teams can scan every supported mode without digging through the API reference.

View use cases

Need the public site?

ThreatMinder.ai is one click away.

Use the official site when the reader needs the external brand story. Use the studio above when the reader needs working integration detail, live payloads, and reference context.

Open official site Return to studio Open batch docs