Back to the catalog

com.geiant/mcp-agentcore

AI governance MCP server for EU AI Act compliance and jurisdiction verification

Open source Repository Open in the app JSON README (API)

About

AI governance MCP server for EU AI Act compliance and jurisdiction verification

Details

Kind
MCP servers
Topic
Security & identity
Publisher
com.geiant
Origin
official
Category
ferramentas
Transport
http
Version
0.1.0
Last push
2026-09-05T07:05:00Z
Repository state
ativo
Language
TypeScript
Added
2026-08-29 03:01:08
Updated
2026-08-29 03:01:08
Origin id
com.geiant/mcp-agentcore

README

# ๐Ÿœ GEIANT

**Geo-Identity Agent Navigation & Tasking**

> *The first AI orchestrator that knows where it is.*

---

## What is GEIANT?

GEIANT is a geospatial AI agent orchestration runtime built on the [GNS Protocol](https://gcrumbs.com). It is a direct competitor to LangChain, CrewAI, and AutoGen โ€” with one structural difference: **every agent has a cryptographic identity bound to an H3 territory, and every task is routed through a compliance enforcement layer before dispatch.**

LangChain doesn't know where it is. GEIANT does.

---

## The Ant Metaphor

In GEIANT, agents are **ants**. Ants are the canonical model of emergent collective intelligence from simple agents following spatial rules. Ant Colony Optimization (ACO) is a real algorithm used in routing and pathfinding. The colony is the orchestrated workflow. The territory is the H3 grid.

- An **ant** (`AntIdentity`) is an agent with a GNS Ed25519 keypair + H3 territory + facet scope + trust tier
- The **colony** is a multi-agent workflow where ants delegate and collaborate
- The **nest** is the Agent Registry โ€” the directory of available ants
- The **trail** is the Virtual Breadcrumb chain โ€” the Proof-of-Jurisdiction audit log

---

## Architecture

```
L6  Multi-Agent Orchestration    โ€” task graph, delegation chain enforcement
L5  IDUP Settlement Layer        โ€” Stellar payment routing per operation  
L4  MCP GIS Switchboard          โ€” GDAL / PostGIS / ArcGIS / QGIS / EO models
L3  Perception Layer             โ€” IBM Prithvi, Microsoft Clay (EO Foundation Models)
L2  Geometry Validation Layer    โ€” GEOS-backed guardrails, self-intersection detection
L1  Geospatial Router            โ€” H3 jurisdiction matching, TierGate enforcement
L0  Agent Identity & Registry    โ€” Ed25519 + H3 + GNS-AIP (LIVE in gns-node)
```

**Phase 0** (this repo): L0 + L1 + L2 core logic, tests, and API scaffold.

---

## Monorepo Structure

```
geiant/
โ”œโ”€โ”€ packages/
โ”‚   โ”œโ”€โ”€ core/          @geiant/core โ€” types, router, validation, registry, jurisdiction
โ”‚   โ””โ”€โ”€ sdk/           @geiant/sdk  โ€” developer-facing SDK (Phase 1)
โ”œโ”€โ”€ apps/
โ”‚   โ””โ”€โ”€ api/           @geiant/api  โ€” Express REST API
โ””โ”€โ”€ docs/              Architecture docs, ADRs
```

---

## The Four Router Gates

Every task passes through four gates before any ant is selected:

1. **Signature Verification** โ€” Ed25519 signature over canonical task JSON
2. **Jurisdiction Resolution** โ€” H3 cell โ†’ country โ†’ regulatory frameworks (GDPR, EU AI Act, FINMA, CCPA...)
3. **Delegation Chain Validation** โ€” human GNS identity โ†’ delegation cert โ†’ scope cells + facets + expiry
4. **Geometry Pre-flight** โ€” GEOS-backed validation: self-intersection, coordinate transposition, unclosed rings

Only tasks that pass all four are dispatched. The router is a compliance enforcement point, not a load balancer.

---

## Getting Started

```bash
# Install dependencies
pnpm install

# Run tests
pnpm test

# Start dev API
pnpm dev

# Test routing endpoint
curl http://localhost:3100/health
curl http://localhost:3100/registry
curl http://localhost:3100/jurisdiction/8728d55ffffffff   # Rome H3 cell
curl http://localhost:3100/route/test
```

---

## Competitive Position

| Feature | LangChain | CrewAI | **GEIANT** |
|---|---|---|---|
| Agent identity | API key | API key | Ed25519 GNS keypair |
| Task routing | Capability + cost | Capability + cost | **H3 jurisdiction + compliance** |
| Audit trail | Logs | Logs | **Virtual breadcrumbs (crypto)** |
| Geometry validation | None | None | **Built-in guardrails** |
| Human accountability | None | None | **Delegation chain** |
| Regulatory compliance | Manual | Manual | **Proof-of-Jurisdiction** |

---

## Patent & IP

GNS Protocol Provisional Patent #63/948,788 (Proof-of-Trajectory).  
GEIANT's Proof-of-Jurisdiction is a second patentable claim extending this.

---

## License

Protocol spec: CC-BY  
Core library: Apache 2.0  
Managed runtime: Proprietary  

GNS Foundation | Globe Crumbs Inc. | ULISSY s.r.l.  
Via Gaetano Sacchi 16, 00153 Roma | ulissy@pec.it | gcrumbs.com

More