Archipelago (archipelago.tools)

tools.archipelagoPublished by archipelago.toolsOfficial publisherv0.2.0Updated Nov 18, 2026

Agent memory for human brains: your agent's plans and decisions as a map you read, correct, share.

Overview

AI-generated overview

Archipelago is a hosted map where an assistant records its plans and decisions as shared, editable items you can read, correct and share.

What you can do
  • Create and update plans, tasks and other typed items on a shared map
  • Read the map through queries and views, and look back over the full change history
  • Undo changes and see which source of authority made each one
  • Define custom types, rules, views and styles to model a problem
  • Share maps with a team or publish them, and run automations on a schedule or on change
When to use it
Useful when you want an assistant's plans and decisions to be visible and correctable by a person, and to carry context between sessions, rather than staying buried in a chat transcript.
Requirements
A remote endpoint at app.archipelago.tools with OAuth sign-in to a workspace account; no hosting needed. Self-hosting is optional and requires Node 24 with a persistent disk, or Postgres for a team.
Before you install
The server is described as early with rough edges. Agents write to the map and can define types and automations that reach into programs or the web, so review what is applied; changes are logged and can be undone. Sharing or publishing a map exposes its contents to anyone with the link.

Installation

In SourceWeft

  1. Open Archipelago (archipelago.tools) in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/tools.archipelago%2Farchipelago/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "archipelago-archipelago-tools": {
      "type": "http",
      "url": "https://app.archipelago.tools/mcp"
    }
  }
}

README

Archipelago

[Tests]

[Agent memory for human brains: islands drawn in stacked rows, the water opening round the title and its line, your agent's plans and decisions as a map you read, correct, share.]

If you're going somewhere uncharted, you should make a map. Archipelago is a map that draws itself while you work, so you and your agents never get lost.

Agent memory for human brains: your agent's plans and decisions as a map you read, correct, share.

Early: built and used daily by its author; expect rough edges.

  • Make a plan: Your agents make plans you can see on the map.
  • Work through it: Watch agents work through the map, keeping it up to date so you don't have to.
  • Customize: Tell your agent any problem you want to solve, and watch it create custom types, rules, views, styles, and more to model it clearly.
  • Never forget: Every change is saved. You and your agents can look back and see every step you've made so far.
  • Share: Collaborate live with your team, or publish for all. Anyone with the link can add it to their own map in a click.
  • Automate: Turn your map into a machine that acts. Automations reach into your programs or the web. Run them on a schedule, or respond to something changing on the map.
  • Own your data: Open source, MIT, and a database you can download any time.

The site is archipelago.tools.

How it works

Archipelago is a small unopinionated core, the rest is yours to shape.

People stay in control. Agents do much of the work, and you decide what needs your approval. Every change records the source of authority, and what is applied can be undone. You stay in charge

The log is the truth. Every change is added to one log and never rewritten. Undo, history, live updates and backups all read the same record. docs/log.md

Everything is an item, every item has a type. Every type extends one of seven kinds. Because Archipelago is built around those kinds, what works on the types we ship works just as well on a type you add.

Plugin architecture. Packs are where opinion enters the system. Create a pack with the item types, link types, view styles, and features you need. A type, view or rule of yours works like the ones that ship. Write a pack

One surface for people and agents. You and your agents use the map through the same tools. What an agent is told is kept on the map, where you can read and change it. The agent tools

One way to read. A query is a filter, a walk and a limit, and a view is a query with its layout. You and your agents read the same query.

Connect your agent

Archipelago runs for you at app.archipelago.tools: there is nothing to host. Ask your agent:

Install Archipelago from https://app.archipelago.tools/connect/install

Or paste one line in a terminal. On Windows (PowerShell):

powershell
irm https://app.archipelago.tools/connect/install.ps1 | iex

On macOS or Linux:

bash
curl -fsSL https://app.archipelago.tools/connect/install.sh | sh

It connects Claude Code, Codex and Cursor where it finds them, and opens your browser once to sign in to your workspace on archipelago.tools; with no account yet, choose Start a workspace there. ChatGPT and Grok Bot are connected in their own apps; the install page says how. From then on each session starts on your map, handed the open work the sessions before it left there and why each piece needs attention. For a server of your own, the same page is at /connect/install on it.

Then say:

Put this project in Archipelago, with the three things I am working on as tasks, and tell me what you would do first.

Your tasks appear on the map right away. To take anything back, open Changes and choose Undo. Any other MCP client works the map at /mcp on the same server.

Host it yourself

Only if you want to run your own server.

Archipelago is one Node 24 server and a persistent disk, MIT licensed, with everything included. The database is embedded; for a team, keep the maps on a Postgres server instead.

bash
git clone https://github.com/AlexReiner98/archipelago.gitcd archipelagonpm installnpm start

Open http://127.0.0.1:3100, go to Workspace and type your name under Owner. To look around first, npm run demo opens a map of Archipelago itself on port 3200, its data kept apart.

To connect a project to your own server, with the hooks and working rules in the project's own files, run this in its folder with the server running:

bash
node -e "fetch('http://127.0.0.1:3100/connect/setup.mjs').then(r=>r.text()).then(t=>import('data:text/javascript,'+encodeURIComponent(t)))"

It lists what it will write (.mcp.json, a few hooks, working rules in CLAUDE.md) and asks first. Add -- --dry-run to only see the list, or -- --remove to take it out.

Read on

Copyright 2026 Aperture Design Tools Inc. MIT License.

Source: README.md at commit 589daef

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.2.0LatestNov 11, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Archipelago integrations