# Abeng — Agent Interface

Abeng is an agentic coordination infrastructure for fragmented economies: it watches public regional data, merges weak signals, routes opportunity dispatches to the right personas with auto-assembled diligence packs, and learns from recipient feedback. The Caribbean is the live proof; the engine is domain-agnostic (economic + climate instances today). Any agent can query it via HTTP, MCP, or CLI — it's deterministic, cited, and deployable now.

**What this is:** A deterministic, citation-backed opportunity engine for the Caribbean. Humans read the dashboard; agents query the API. The same engine answers both.

**Base URL (local):** `http://localhost:8080`

**Base URL (hosted):** `https://future-caribbean.vercel.app`

---

## Endpoints

| Method | Path | Description |
|--------|------|-------------|
| POST | `/mcp` | Model Context Protocol over Streamable HTTP. Point an MCP client here and the desk's tools appear — nothing to install. |
| POST | `/api/ask` | Ask a question against the current Dispatch Desk. Returns a deterministic, cited answer. |
| GET | `/api/status` | Engine health: source status, cycle info, dispatch counts, feedback outcomes. |
| GET | `/api/validation-packs` | Index of all validation packs for the current cycle. |
| GET | `/api/validation-packs/{signal_id}` | Full validation pack (sector hypotheses, projects, procurement, intro targets, unresolved questions). |
| GET | `/api/domains` | List all configured engine instances (live + blueprint). |
| GET | `/api/reasoning` | Cross-signal synthesis from the reasoning agent. |
| POST | `/api/feedback/apply` | Apply recipient feedback to reweight next-cycle priorities (write). |
| GET | `/api/tools.json (see also /feed.xml — RSS of the latest signals)` | **Machine-readable manifest of all tools.** Ingest this to self-configure. |
| GET | `/llms.txt` | This file. |
| GET | `/agents.md` | Framework-specific connection instructions. |

---

## Quick Start (curl)

```bash
# Add the desk to an MCP client — no clone, no install
#   { "mcpServers": { "abeng": { "url": "https://future-caribbean.vercel.app/mcp" } } }

# Ask the desk a question
curl -X POST https://future-caribbean.vercel.app/api/ask \
  -H "Content-Type: application/json" \
  -d '{"question": "explain the lead signal"}'

# Get the tool manifest (for agent self-configuration)
curl https://future-caribbean.vercel.app/api/tools.json

# Get validation packs index
curl https://future-caribbean.vercel.app/api/validation-packs
```

**See also:** `/agents.md` for framework-specific setup (Claude/MCP, Hermes, OpenClaw, plain HTTP).