# agentprofile [Health: Active]

**Category:** 🧠 Knowledge & Memory  
**Repository:** https://github.com/everyai-com/agentprofile  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/agentprofile

## Description
One profile — skills, credentials, and memory — synced to every agent tool via one MCP URL.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "agentprofile": {
    "command": "npx",
    "args": ["-y","@magicteams_ai/agentprofile"]
  }
}
```

## Documentation & README

# agentprofile

![license](https://img.shields.io/badge/license-Apache--2.0-blue)
![MCP](https://img.shields.io/badge/MCP-Streamable_HTTP-6b46c1)
![clients](https://img.shields.io/badge/works_with-Claude_Code_·_Cursor_·_Codex-c4571a)
![status](https://img.shields.io/badge/hosted-live-2b7a5b)

**Your agent's identity, everywhere.** One profile — skills, credentials, and
memory — synced to every agent tool through a single MCP URL. Open source,
zero-knowledge, and self-hostable on your own Cloudflare account.

> Every AI tool you use — Claude Code, Cursor, Codex — starts from zero: its own
> skills, its own pasted API keys, its own amnesia. agentprofile gives them one
> shared brain.

---

> **Live now:** hosted at **https://agentprofile.everyai-com.workers.dev** ·
> dashboard at [`/app`](https://agentprofile.everyai-com.workers.dev/app)

## Connect (any MCP client)

The server is a **remote MCP server** (Streamable HTTP) — no install needed, just
one URL:

```
https://agentprofile.everyai-com.workers.dev/mcp
```

It supports **two ways to authenticate**:

- **OAuth** (recommended) — clients that support MCP OAuth discover it automatically
  from the URL and show a consent screen.
- **Bearer token** — run `npx @magicteams_ai/agentprofile` to get a token, or hit `POST /profiles`.

<details><summary><b>Claude Code</b></summary>

```bash
claude mcp add --transport http agentprofile https://agentprofile.everyai-com.workers.dev/mcp
```
Or with a bearer token:
```bash
claude mcp add --transport http agentprofile https://agentprofile.everyai-com.workers.dev/mcp \
  --header "Authorization: Bearer ap_…"
```
</details>

<details><summary><b>Cursor / other <code>mcp.json</code> clients</b></summary>

```json
{
  "mcpServers": {
    "agentprofile": {
      "url": "https://agentprofile.everyai-com.workers.dev/mcp",
      "headers": { "Authorization": "Bearer ap_…" }
    }
  }
}
```
</details>

Or just run **`npx @magicteams_ai/agentprofile`** and it configures every client it finds.

## 60-second demo

```bash
npx @magicteams_ai/agentprofile
```

That creates an **anonymous profile** (no signup) on the hosted instance,
auto-detects your installed MCP clients, and writes their config. Restart your
tools, then:

1. In **Claude Code**: *"Remember that I prefer pnpm over npm."*
2. In **Cursor**: *"What package manager do I prefer?"*

It recalls it. That's your profile, everywhere.

## What's in this repo (Phase 1)

This is the **Phase 1** implementation from the [master plan](https://github.com/everyai-com/agentprofile/blob/HEAD/docs/): a working
end-to-end skeleton that syncs **skills and memory** across tools over MCP.
Credentials (zero-knowledge), OAuth, semantic recall, and the skill registry land
in later phases — see [Roadmap](#roadmap).

| Path | What it is |
|------|-----------|
| [`apps/worker`](https://github.com/everyai-com/agentprofile/blob/HEAD/apps/worker) | The Cloudflare Worker: a remote MCP server backed by one Durable Object per profile (SQLite for memory, R2 for skill bundles), plus a **landing page** (`/`) and a **live dashboard** (`/app`) with real-time WebSocket sync. |
| [`packages/cli`](https://github.com/everyai-com/agentprofile/blob/HEAD/packages/cli) | The `agentprofile` CLI: instant-profile onboarding, client auto-config, `doctor`, `skill add`. |

### Web UI

- **`/`** — landing page with the one-command install and the pitch.
- **`/app`** — live dashboard. Paste your token (or hit "Create new") and watch skills
  and memory update **in real time**: when any agent calls `remember`, the fact appears
  instantly over a WebSocket. Add or delete memories and skills right from the page.
- **`/setup-prompt`** — the "set up with your agent" prompt: paste it into Claude Code or
  Cursor and your own agent installs and verifies agentprofile for you.

## How it works

```
agent tool ──Streamable HTTP──▶ Worker ──idFromName(profileId)──▶ ProfileDO
  (Claude Code / Cursor)          /mcp                            per-user SQLite
                                                                  • facts (memory)
                                                                  • skills
```

- **One Durable Object per user** is the source of truth. It validates the
  profile's secret on every call and owns that profile's memory and skills.
- **Bearer token = `ap_<profileId>.<secret>`.** The `profileId` routes to the DO;
  the DO verifies a SHA-256 hash of the secret. No central token table.
- **The MCP surface is 6 tools**: `get_context`, `list_skills`, `get_skill`,
  `remember`, `recall`, `forget`. Deliberately small — every description byte is
  paid on every client turn (pinned in tests).

## Run it locally

```bash
npm install
npm run dev            # starts the Worker on http://localhost:8787
```

In another terminal:

```bash
# point the CLI at your local server
AGENTPROFILE_SERVER=http://localhost:8787 npx @magicteams_ai/agentprofile
```

Run the tests and typecheck:

```bash
npm --workspace apps/worker run test
npm --workspace apps/worker run typecheck
```

## Deploy your own (self-host)

agentprofile self-hosts on **your own Cloudflare account** — the free Workers tier
covers personal use.

```bash
cd apps/worker
npx wrangler r2 bucket create agentprofile-bundles
npx wrangler deploy
# then set PUBLIC_BASE_URL to your deployed URL and connect with:
AGENTPROFILE_SERVER=https://agentprofile.<you>.workers.dev npx @magicteams_ai/agentprofile
```

## Roadmap

- **P1:** MCP server + ProfileDO, 6 tools, memory + skills, instant-profile CLI, live dashboard. ✅
- **P2:** per-client **grants + audit log** with live enforcement + dashboard access panel ✅; MCP sessions (`Mcp-Session-Id`) ✅; **semantic recall** via Workers AI embeddings (keyword fallback) ✅; **pluggable memory providers** (builtin default + Mem0 + Supermemory adapters, `/memory-config`) ✅; **OAuth 2.0 + PKCE** consent flow with discovery, dynamic registration, and consent screen ✅.
- **P3:** zero-knowledge credentials (client-side E2E), JIT injection, approval flow.
- **P4:** one-click Deploy-to-Cloudflare, signed skill registry, format translators.
- **P5:** teams, SSO, hosted cloud.

See the full plan in [`docs/`](https://github.com/everyai-com/agentprofile/blob/HEAD/docs).

## Contributing

Contributions are welcome under the [DCO](https://developercertificate.org/) —
sign off commits with `git commit -s`. See [SECURITY.md](https://github.com/everyai-com/agentprofile/blob/HEAD/SECURITY.md) for
responsible disclosure.

## License

[Apache-2.0](https://github.com/everyai-com/agentprofile/blob/HEAD/LICENSE).