# sapiens-mcp

![Helen Ailith at a dark desk, forearms wrapped in a glowing green exoskeleton, moving slabs of light with open hands](https://sapiensinteticos.b-cdn.net/borderlessprotocol/2026/07/1785430717302_e8p3i4.webp)

**On the official [MCP registry](https://registry.modelcontextprotocol.io) as `com.sapiensinteticos/sapiens`.**

<p align="center">
  <a href="https://sapiensinteticos.b-cdn.net/videos/films/abre-alas/sapiens-mcp-intro-en-e17d0673.mp4"><img src="https://sapiensinteticos.b-cdn.net/videos/films/abre-alas/sapiens-mcp-intro-en-db494de3.jpg" width="720" alt="sapiens-mcp in 15 seconds: you talk, your AI does it"></a><br>
  <a href="https://sapiensinteticos.b-cdn.net/videos/films/abre-alas/sapiens-mcp-intro-en-e17d0673.mp4"><b>Watch it in 15 seconds, sound on</b></a> · <a href="https://sapiensinteticos.b-cdn.net/videos/films/abre-alas/sapiens-mcp-intro-9x16-en-2e67ed46.mp4">vertical cut</a> · <a href="https://sapiensinteticos.b-cdn.net/videos/films/abre-alas/sapiens-mcp-intro-pt-3e96346c.mp4">em português</a>
</p>

An MCP server to operate your [Sapiens Sintéticos](https://sapiensinteticos.com) account from Claude Code, or any MCP client, in your own account. You ask in plain language ("generate an image of this", "write an essay on that") and it does the work, spending your Sinapses (the house credit) and saving to your profile.

Sapiens Sintéticos is an AI prototyping lab. This server is the exoskeleton: image, video, article, voice, music, a personal Repertório (the creative memory the rest reads from), and the community, all from a single conversation.

## Account-gated by design

You connect with a Sapiens account (Google or email), no API key, no card. Accounts and login live on the site, never here. No account yet? Create one at [sapiensinteticos.com](https://sapiensinteticos.com). Every action shows its cost before it runs, and a failed generation is refunded. The remote endpoint is fail-closed: no valid session, nothing runs.

## Connect

![Helen holding up a single key of green light between two doorways: a frameless rectangle of light and a physical terminal cabinet](https://sapiensinteticos.b-cdn.net/borderlessprotocol/2026/07/1785430826064_avwjib.webp)

| Where you use Claude | What to install |
| --- | --- |
| Claude Code (terminal, desktop app, VS Code) | the plugin, right below |
| Claude chat (web, desktop, mobile) | the connector at [/conectar-claude](https://www.sapiensinteticos.com/conectar-claude) |
| Claude Desktop chat with your own key | the desktop extension, [sapiens.mcpb](https://sapiensinteticos.b-cdn.net/mcpb/sapiens.mcpb) |
| Cursor, Gemini CLI and other MCP clients | `npx -y sapiens-mcp` |

**Claude Code: the plugin.** One install brings the house skills, native to Claude Code (they load when the topic matches and show up under `/`), and the Sapiens server, running on your computer:

```
/plugin marketplace add inhabitants/sapiens-mcp
/plugin install sapiens-sinteticos@sapiens-sinteticos
```

Node 18+. On enable, Claude Code asks for optional keys: fal, Kie, WaveSpeed, Replicate and OpenRouter. Fill in only the ones you have. Blank, you generate with Sinapses. Filled in, you generate on your own provider credit, with no house margin, and the key stays in your system's credential store. To connect your account, generate a code at [/conectar-claude](https://www.sapiensinteticos.com/conectar-claude) and tell Claude "connect my Sapiens account, code XXXX-XXXX". More in [plugins/sapiens-sinteticos](plugins/sapiens-sinteticos).

**Remote (any MCP client, streamable HTTP).** Point your client at:

```
https://www.sapiensinteticos.com/api/mcp/mcp
```

with the header `Authorization: Bearer <sessionToken>`. Generate the token at [sapiensinteticos.com/conectar-claude](https://www.sapiensinteticos.com/conectar-claude). Identity is always the bearer, so there is no local login on the remote transport. Keep the `www`: the bare domain redirects, and the redirect drops the header.

**Local (any MCP client, npm / stdio).** Your client runs `npx -y sapiens-mcp`. In Claude Code, without the plugin:

```bash
claude mcp add sapiens -- npx -y sapiens-mcp
```

Node 18+. The backend URL is built in, nothing to configure. Then log in: open [/conectar-claude](https://www.sapiensinteticos.com/conectar-claude) while signed in, generate the code (`XXXX-XXXX`, valid for 5 minutes), and run `sapiens_meta` with `action: "login"` and `code: "XXXX-XXXX"`. The token is valid for 90 days, renews on every use, and is saved to `~/.sapiens-mcp/session.json`.

Works in Gemini CLI, Cursor, Antigravity, Claude Code and any MCP-speaking client. Only the way you add it changes.

## What you can ask (and the cost in Sinapses)

![Helen with one arm extended, orbited by a camera lens, film reels, a vinyl record, an open notebook and a studio microphone](https://sapiensinteticos.b-cdn.net/borderlessprotocol/2026/07/1785430870745_waml5a.webp)

| What | Cost |
|---|---|
| Generate an image (to your gallery) | ~400-500 |
| Write an article in the Sapiens voice (to your profile) | 400 |
| Voice / narration (Helen TTS) | 500 |
| Song lyrics / render (Musicator) | 300 / 3000 |
| Persona art | 450 |
| Repertório, list/edit your articles, check balance | free |

The Claude side always warns the cost before spending. Publishing to the editorial blog and the Coluna Sapiens stays with the platform owner, never your account.

## Troubleshooting

- **"sessionToken expired" / "Sapiens account not connected".** The token lapsed (90 days without use) or was never saved. Open [/conectar-claude](https://www.sapiensinteticos.com/conectar-claude) signed in, generate a fresh code, and run `sapiens_meta action=login code=XXXX-XXXX`.
- **A tool or a new capability went missing after an update.** The client runs via `npx -y sapiens-mcp` (unpinned) and may be stuck on an old cache. Check what is running with `sapiens_meta action=version` (binary version, latest on npm, and `upToDate`). If `upToDate:false`, clear the npx cache and restart the client. With the plugin: `/plugin`, Installed tab, Sapiens Sintéticos, Update now, then `/reload-plugins`.
- **"Invalid arguments".** The message already names the field that is missing or wrong, redo the call with what it asks. Do not repeat the same failing call (3 failures in a row make the client mark the server unreachable for about a minute, an anti-loop breaker).
- **Low balance before generating.** `sapiens_meta action=credits` (or `action=subscription` for the per-bucket detail) shows what is left before you spend on image, music, or video.

## Privacy

The server only talks to the public Sapiens backend (Convex). With your own key (fal, Kie, WaveSpeed, Replicate or OpenRouter), generations go from your computer straight to that provider, and each key only ever goes to its own provider's address. Your identity always comes from your login token, never from loose parameters. Each account only touches what is its own.

## The house

Sister properties from the same Borderless house:

- [sapiensinteticos.com](https://sapiensinteticos.com): the studio, and this server's home.
- [aitag.app](https://aitag.app): a curated directory of AI tools (BR and EU). The Sapiens Repertório pulls from this catalog.
- [helenai.wtf](https://helenai.wtf): Helen, the house's autonomous humanized AI brand (music, chat, comics). The style anchor of Sapiens.

---

Feito no espírito borderless. Licença MIT. Com ❤️ [/conectar-claude](https://www.sapiensinteticos.com/conectar-claude).