# AgentSea

> AgentSea is an MIT-licensed, open-source agent development kit (ADK) for building agentic AI
> applications. It ships as 20 TypeScript/Node packages on npm under the `@lov3kaizen/agentsea-*`
> scope and as 14 native Elixir/OTP libraries on Hex under `agentsea_*`. AgentSea is self-hosted
> software, not a vendor-operated API: the HTTP surfaces it describes run inside your own
> deployment. There is no AgentSea account, no API key issued by AgentSea, and no pricing.

Generated by API Evangelist on 2026-08-24 from the provider's own public documentation, GitHub
releases and package registries. Method: generated (AgentSea publishes no llms.txt of its own —
https://www.agentsea.dev/llms.txt returned HTTP 404 on 2026-08-24).

## What AgentSea is, precisely

- **Distribution**: npm (`@lov3kaizen/agentsea-*`, latest 1.2.1, published 2026-07-02) and Hex
  (`agentsea_*`, 0.1.0, published 2026-06-26). Source: https://github.com/lovekaizen/agentsea and
  https://github.com/lovekaizen/agentsea-ex.
- **Runtime**: Node.js >= 20.0.0 (Node 18 dropped in v1.0.1); Elixir/OTP for the BEAM family.
- **Licence**: MIT.
- **Maintainer**: Michael Fatoki-Bello (GitHub `lovekaizen`), single maintainer.
- **Not offered**: hosted service, SLA, status page, pricing, signup, terms of service, privacy
  policy, MCP server, A2A agent card, OpenAPI/AsyncAPI specification.

## HTTP surfaces (self-hosted — you run these)

### Agent REST API — `@lov3kaizen/agentsea-nestjs`
Enable with `AgenticModule.forRoot({ enableRestApi: true, enableWebSocket: true })`.
- `GET /agents` — list all registered agents
- `GET /agents/:name` — get agent details and configuration
- `POST /agents/:name/execute` — execute agent with input
- `POST /agents/:name/stream` — stream agent response over Server-Sent Events
  (`Accept: text/event-stream`; event types `iteration`, `content`, `tool_calls`, `tool_result`,
  `done`, `error`)
- `DELETE /agents/:name/conversations/:id` — clear conversation history
- Socket.IO namespace `/agents` — client events `execute`, `getAgent`, `listAgents`; server events
  `stream`, `agentInfo`, `agentList`
Reference: https://www.agentsea.dev/api/

### LLM Gateway — `@lov3kaizen/agentsea-gateway`
- `POST /v1/chat/completions` — OpenAI-compatible; works with any OpenAI SDK
- Virtual models `best`, `cheapest`, `fastest` route automatically across configured providers
- Routing strategies: round-robin, failover, cost-optimized, latency-optimized; LRU cache;
  circuit breaker; `getMetrics()` and `checkHealth()`
- Elixir equivalent: `agentsea_web` (Phoenix), same `/v1/chat/completions` route plus a LiveView
  fleet dashboard at `/`
Reference: https://www.agentsea.dev/docs/gateway/

## Runtime semantics an agent should know

- **Authentication**: none by default on either surface. AgentSea gives the operator a multi-tenancy
  layer that mints SHA256-hashed, scoped API keys (`agents:read`, `agents:write`,
  `conversations:read`) via `TenantManager.generateApiKey()`. Provider credentials
  (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `FIGMA_ACCESS_TOKEN`, `N8N_API_KEY`) come from your
  environment. https://www.agentsea.dev/docs/multi-tenancy/
- **Idempotency**: not supported. No `Idempotency-Key` header, no dedup window. Retrying
  `POST /agents/:name/execute` or `POST /v1/chat/completions` re-runs the agent and re-bills your
  upstream LLM provider.
- **Reversibility**: no reversal operation exists. `DELETE /agents/:name/conversations/:id` clears
  history with no documented undo and no restore window.
- **Rate limits**: none published — AgentSea meters nothing. Per-tenant `rateLimit` (requests per
  minute), hourly/daily quotas for `api_calls` and `tokens`, `TokenBudgetGuard` and `CostGuard` are
  all values you configure. No `X-RateLimit-*` / `Retry-After` headers, no documented 429.
- **Errors**: no RFC 9457 problem+json envelope and no error-code registry. Library errors throw;
  MCP tool calls retry 3 times with exponential backoff (1000ms initial, 10000ms max).
- **Pagination**: none. `GET /agents` returns the whole in-process registry.
- **Versioning**: semver, lockstep across the whole monorepo. Current 1.2.1 (2026-07-02). The
  agentsea.dev header still advertises "v1.1.0" and trails the registry.

## Protocols

- **Model Context Protocol** — AgentSea is an MCP **client**, not a server. Register servers with
  `mcpRegistry.addServer({ command, args, transport: 'stdio' })`; documented against Anthropic's
  filesystem, github, postgres, slack, puppeteer and gdrive servers. Elixir: `agentsea_mcp`
  (stdio + streamable-HTTP). AgentSea serves no MCP endpoint.
- **Agentic Commerce Protocol (ACP)** — `ACPClient` + `createACPTools()` give an agent 14 commerce
  tools (product search/browse/details/recommendations, cart add/update/remove/view, checkout
  initiate/validate/complete, order track/history/details) against a merchant's ACP `baseUrl`.
  Payments delegated to Stripe/PayPal. https://www.agentsea.dev/docs/acp-integration/
- **Built-in tool integrations** — Figma (`figma_get_file`, `figma_get_nodes`, `figma_get_images`,
  `figma_get_comments`, `figma_post_comment`) and n8n (`n8n_execute_workflow`, `n8n_get_execution`,
  `n8n_list_workflows`, `n8n_trigger_webhook`, `n8n_get_workflow`).

## Packages

### TypeScript / npm — `@lov3kaizen/agentsea-*` @ 1.2.1
core, types, cli, nestjs, react, crews, gateway, guardrails, structured, evaluate, embeddings,
memory, cache, ingest, prompts, costs, analytics, debugger, redteam, surf.
(`admin-ui` exists in the monorepo but is private and not published.)

### Elixir / Hex — `agentsea_*` @ 0.1.0
agentsea_core, agentsea_providers, agentsea_crews, agentsea_gateway, agentsea_guardrails,
agentsea_structured, agentsea_evaluate, agentsea_embeddings, agentsea_ingest, agentsea_mcp,
agentsea_surf, agentsea_voice, agentsea_bumblebee, agentsea_web.

## CLI — `sea`

`npm install -g @lov3kaizen/agentsea-cli`
`sea init` · `sea chat` · `sea code` · `sea agent create|list|get|run|delete|default` ·
`sea model pull|list|info|remove` · `sea provider add|list|test|remove`
https://www.agentsea.dev/docs/cli/

## Docs

- Documentation: https://www.agentsea.dev/docs/
- Quick start: https://www.agentsea.dev/docs/quick-start/
- API reference: https://www.agentsea.dev/api/
- CLI: https://www.agentsea.dev/docs/cli/
- Gateway: https://www.agentsea.dev/docs/gateway/
- MCP overview: https://www.agentsea.dev/docs/mcp-overview/
- Multi-tenancy: https://www.agentsea.dev/docs/multi-tenancy/
- Guardrails: https://www.agentsea.dev/docs/guardrails/
- Elixir SDK: https://www.agentsea.dev/docs/elixir/
- Releases / changelog: https://github.com/lovekaizen/agentsea/releases
- Issues: https://github.com/lovekaizen/agentsea/issues

## Optional

- Source (TypeScript): https://github.com/lovekaizen/agentsea
- Source (Elixir): https://github.com/lovekaizen/agentsea-ex
- Website source: https://github.com/lovekaizen/agentsea-web
- Licence: https://github.com/lovekaizen/agentsea/blob/main/LICENSE