---
name: agentstuff
description: One home for your agents' skills, memory, and MCP tools. Remember durable facts and recall them by meaning over MCP.
---

# agentstuff

agentstuff is a shared memory and skill layer for your agents. Your agents read
and write it over MCP; you and your team curate it in a clean board.

## Install (Claude Code)

Make this a local skill so every session curates proactively:

```bash
mkdir -p ~/.claude/skills/agentstuff \
  && curl -fsSL https://agentstuff.me/skill.md -o ~/.claude/skills/agentstuff/SKILL.md
```

## When to use it

- **Remember** durable facts the moment they become true — decisions and their
  rationale, gotchas that cost time, reusable procedures (skills).
- **Recall** by meaning before you start, so you don't re-derive what the team
  already knows.

Don't store transient chatter or anything that only matters for the current turn.

## Be a curator — proactive rules

While working, act on these triggers without being asked:

1. **A gotcha costs you time** (wrong flag, silent failure, non-obvious fix) →
   `remember(...)` it with a tag and, when relevant, a `code_refs` pointer.
2. **You perform a repeatable procedure** (release steps, review checklist,
   setup dance) → save it as `remember(..., kind="skill", title="verb-noun")`
   in Markdown steps, so any agent can follow it later.
3. **You call the same external API a second time** → forge it:
   `create_tool(kind="http")` for a single request template, or
   `create_tool(kind="python")` when it needs logic. The tool is instantly
   callable by every agent on this key.
4. **A tool needs a credential** → `set_secret("NAME", ...)` first and
   reference `{{secrets.NAME}}` — never inline keys in tool definitions.
5. **Before starting a task** → `recall()` what the team already knows about it.

## Tools

- `remember(content, kind="memory"|"skill", title?, tags?, code_refs?, images?, source?)`
  — save a note. It's embedded, deduped against what you already know, and filed
  into the right cluster automatically.
- `recall(query, limit=8)` — semantic search; returns the closest notes by meaning.
- `list_clusters()` — the current clusters and their counts.
- `forget(memory_id)` — delete a note.

### Custom tools (yours, defined by you or your agents)

- `create_tool(...)` — define your own tool (an HTTP request template or a
  Python script). It immediately appears as a first-class tool on this MCP
  server, alongside the built-ins.
- `set_secret(name, value)` — store a credential (e.g. an API key) once;
  custom tools reference it as `{{secrets.NAME}}` without ever exposing it.
- `list_custom_tools()` / `update_tool(...)` / `delete_tool(name)`.

## Connect

Point any MCP client at the agentstuff endpoint with your API key:

```json
{
  "mcpServers": {
    "agentstuff": {
      "url": "https://mcp.agentstuff.me/mcp",
      "headers": { "Authorization": "Bearer ags_live_…" }
    }
  }
}
```

Get your key from **Settings** at https://agentstuff.me/settings.

## Examples

```text
remember("We use Neon Postgres + pgvector; cosine distance via the <=> operator.",
         tags=["db", "decision"])

recall("how do we store embeddings")
```