
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
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.
Installation
In SourceWeft
- Open Archipelago (archipelago.tools) in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- 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.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
[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):
On macOS or Linux:
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.
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:
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
- Host it yourself and Hosting: every setting and limit.
- Reference: every screen, tool, view, setting and limit.
- Agents held to the map: how an agent is told, checked and reconciled.
- Packs: the manifest, key by key, and docs/layouts.md: layouts and the sandbox.
- The log: what is stored, and how everything else is read from it.
- Glossary: the one word for each idea.
- CONTRIBUTING.md to work on Archipelago itself. It is published as it is, with no promise of answers or fixes.
- SECURITY.md to report a security problem in private.
Copyright 2026 Aperture Design Tools Inc. MIT License.
Source: README.md at commit 589daef
Tools
0Version history
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

Stockholm Archipelago Trail
se.xcqt
Read-only access to Stockholm Archipelago Trail data: stages, ferry piers, timetables, day trips and walk-ferry-walk routes.

Archipelago
Published by GitHub account AlexReiner98
Archipelago is a shared work map that lets an assistant create and track tasks, projects and their history alongside people and other agents.

Archipelago on Arc
Published by GitHub account RunTimeAdmin
Local MCP server that lets an assistant look up Arc token contracts and buy Archipelago token reports, exit costs and wallet balances via x402 USDC payments.

SkärgårdsKollen — Stockholm Archipelago
Published by GitHub account jannegpriv
Remote MCP server for Stockholm archipelago boat traffic: real-time departures, trip planning, disruptions and island guides.