npm sapiens-mcpstreamable-httpMITupdated 1mo ago
On the official MCP registry as com.sapiensinteticos/sapiens.
¿Qué puedes hacer con Sapiens Sintéticos?
sapiens-mcp
On the official MCP registry as com.sapiensinteticos/sapiens.
An MCP server to operate your Sapiens Sintéticos 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. 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 (two ways)
Remote (any MCP client, streamable HTTP). Point your client at:
https://sapiensinteticos.com/api/mcp/mcp
with the header Authorization: Bearer <sessionToken>. Generate the token at sapiensinteticos.com/conectar-claude. Identity is always the bearer, so there is no local login on the remote transport.
Local (Claude Code, npm / stdio).
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 while signed in, generate the code (XXXX-XXXX, valid for 5 minutes), and run sapiens_meta with action: "login" and code: "XXXX-XXXX". The 30-day token is saved to ~/.sapiens-mcp/session.json.
Works in Claude Code (the tested path), Gemini CLI, Cursor, Antigravity, and any MCP-speaking client. Only the way you add it changes.
What you can ask (and the cost in Sinapses)
| 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 30-day token lapsed or was never saved. Open /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 withsapiens_meta action=version(binary version, latest on npm, andupToDate). IfupToDate:false, clear the npx cache and restart the client. - "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(oraction=subscriptionfor 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). 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: the studio, and this server's home.
- aitag.app: a curated directory of AI tools (BR and EU). The Sapiens Repertório pulls from this catalog.
- 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.
Instalación
Añade Sapiens Sintéticos a tu cliente. Elige el que uses.
{
"servers": {
"sapiens-mcp": {
"type": "http",
"url": "https://www.sapiensinteticos.com/api/mcp/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add sapiens-mcp -- npx -y sapiens-mcpcodex mcp add sapiens-mcp -- npx -y sapiens-mcpamp mcp add sapiens-mcp -- npx -y sapiens-mcp{
"mcpServers": {
"sapiens-mcp": {
"command": "npx",
"args": [
"-y",
"sapiens-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"sapiens-mcp": {
"command": "npx",
"args": [
"-y",
"sapiens-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"sapiens-mcp": {
"command": "npx",
"args": [
"-y",
"sapiens-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"sapiens-mcp": {
"command": "npx",
"args": [
"-y",
"sapiens-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"sapiens-mcp": {
"command": "npx",
"args": [
"-y",
"sapiens-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"sapiens-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"sapiens-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"sapiens-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"sapiens-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y sapiens-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Puntuación
39 / 100
Incompleta
- Documentación25/25
- Mantenimiento22/25
- Confianza13/20
- Capacidad0/15
- Instalación15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 40 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Historial de versiones
| Versiones | Publicada |
|---|---|
| 1.62.5Última | 29 ago 2026 |
| 1.62.3 | 29 ago 2026 |
| 1.62.2 | 29 ago 2026 |
| 1.62.1 | 28 ago 2026 |
| 1.62.0 | 28 ago 2026 |
| 1.61.2 | 28 ago 2026 |
| 1.61.1 | 27 ago 2026 |
| 1.61.0 | 25 ago 2026 |
| 1.59.1 | 24 ago 2026 |
| 1.59.0 | 23 ago 2026 |
| 1.58.0 | 22 ago 2026 |
| 1.57.1 | 19 ago 2026 |
| 1.57.0 | 19 ago 2026 |
| 1.56.1 | 18 ago 2026 |
| 1.56.0 | 18 ago 2026 |
| 1.55.0 | 18 ago 2026 |
| 1.54.1 | 17 ago 2026 |
| 1.54.0 | 14 ago 2026 |
| 1.53.1 | 13 ago 2026 |
| 1.53.0 | 13 ago 2026 |
| 1.52.0 | 12 ago 2026 |
| 1.51.1 | 11 ago 2026 |
| 1.51.0 | 11 ago 2026 |
| 1.50.0 | 11 ago 2026 |
| 1.49.0 | 10 ago 2026 |
| 1.48.0 | 10 ago 2026 |
| 1.47.0 | 9 ago 2026 |
| 1.46.5 | 7 ago 2026 |
| 1.46.4 | 4 ago 2026 |
| 1.46.3 | 4 ago 2026 |
| 1.38.0 | 20 jul 2026 |