Metadata-Version: 2.4
Name: defoneos-swarm-mcp
Version: 1.0.0
Summary: DEFONEOS Swarm MCP — Mava multi-agent RL + PX4 drone swarm coordination for defence ISR
Author-email: "MEOK AI Labs (CSOAI LTD)" <team@meok.ai>
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.28.0
Requires-Dist: pydantic>=2.0
Dynamic: license-file

# DEFONEOS Swarm MCP — Mava + PX4 Drone Swarm Coordination

[![PyPI version](https://img.shields.io/pypi/v/defoneos-swarm-mcp.svg)](https://pypi.org/project/defoneos-swarm-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![MCP](https://img.shields.io/badge/MCP-1.28.0-blue)](https://modelcontextprotocol.io)

**Mava multi-agent RL + PX4 drone swarm coordination for defence ISR.**  
Sovereign swarm engine. 6 mission templates. FreeTAKServer integration.

## Install

```bash
pip install defoneos-swarm-mcp
```

## 30-Second Demo

```bash
python -c "
from defoneos_swarm_mcp.server import define_swarm_mission, simulate_swarm
m = define_swarm_mission({'mission_id': 'OP-001', 'template': 'isr_sweep', 'lat': 54.0, 'lon': -1.5})
print(f\"{m['agent_count']} agents in {m['mission']['formation']} formation — Sigil: {m['sigil']}\")
s = simulate_swarm({'template': 'isr_sweep', 'duration_s': 300, 'wind_ms': 5})
print(f\"Coverage: {s['results']['coverage_km2']} km², Success: {s['results']['mission_success']}\")
"
```

## Tools

| Tool | Description |
|------|-------------|
| `define_swarm_mission` | Define a swarm mission from 6 templates (ISR sweep, perimeter, convoy, etc.) |
| `allocate_swarm_roles` | Mava-style utility-based multi-agent role allocation |
| `simulate_swarm` | Simulate swarm with wind, jamming, and coverage metrics |
| `generate_swarm_tak` | Generate TAK Data Package XML for FreeTAKServer |
| `list_swarm_templates` | List all pre-configured mission templates |

## Templates

| Template | Agents | Formation | Doctrine |
|----------|--------|-----------|----------|
| ISR Sweep | 6 | Line Abreast | ATP 3-20.98 |
| Perimeter Watch | 8 | Orbit | JP 3-10 |
| Convoy Escort | 4 | Diamond | ATP 3-21.8 |
| Target Handoff | 3 | Relay | JP 3-60 |
| Battle Damage | 2 | Stacked | JP 3-60 |
| EW Screen | 10 | Grid | JP 3-12 |

## PX4 Integration

Supports all standard PX4 flight modes: `stabilized`, `altitude`, `position`, `mission`, `loiter`, `rtl`, `offboard`, `follow`.

## Pricing

- **Free**: 1,000 calls/month
- **Pro (£79/mo)**: Unlimited + audit trail
- **Gov (£499/mo)**: Air-gapped + full attestation

**MEOK AI Labs (CSOAI LTD)** — Sovereign. British. Forever.
