Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

StoryOS

✓ del servicio · storyos.dev

de StoryFunnelsversión 0.1.2i★ 8 (Estrellas de todo el repositorio)iComputadora o nubeSitio oficial ↗
Nombre en el registrodev.storyos/storyos

Cómo instalar

What it does

Your StoryOS workspace (records, approvals and agents) for Claude, ChatGPT and any MCP client.

  • Connects Computadora o nube
  • Account or key Cloud: Sign in to the service when you connect (OAuth) · Local: Needs STORYOS_TOKEN
  • Category Otros

Por qué está en este puesto

Está en la pestaña “Apps que se conectan a la IA”, que se ordena sin estrellas, en este orden

1. En el directorio de conectores de ClaudeNo
2. Probado por nuestro equipoNo
3. Útil para usuarios de TailandiaNo
4. Uso sin estrellas20/100Popularidad 0 · Actualidad 12 · Sigue respondiendo 8 · Me gusta de usuarios +0
5. Registrado el2026-11-18

Me gusta de usuarios: 0 · Suma como máximo 5 puntos (1 por persona). No se puede comprar.

Calidad: Pasó 4/5 revisiones básicas (se muestra, no ordena)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala StoryOS. Sigue https://mcp.popnx.com/i/storyos.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 4/5 revisiones · Lo que preguntas pasa por el servidor del autor (mcp.storyos.dev) · ✓ Comandos revisados el 19 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreStoryOS
    Remote MCP server URL · Direcciónhttps://mcp.storyos.dev/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsStoryOS

  4. Pruébalo

    Usa StoryOS y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando StoryOS o muestra una herramienta de StoryOS en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreStoryOS
    Connection · Direcciónhttps://mcp.storyos.dev/mcp
  3. Elige StoryOS en un chat

    Abre un chat nuevo y elige StoryOS en tus plugins antes de escribir

  4. Pruébalo

    Usa StoryOS y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando StoryOS o muestra una herramienta de StoryOS en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user storyos https://mcp.storyos.dev/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver StoryOS en la lista como conectado

  4. Pruébalo

    Usa StoryOS y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando StoryOS o muestra una herramienta de StoryOS en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa StoryOS y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando StoryOS o muestra una herramienta de StoryOS en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa StoryOS y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando StoryOS o muestra una herramienta de StoryOS en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://mcp.storyos.dev/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa StoryOS💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user storyos https://mcp.storyos.dev/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "storyos": {
      "url": "https://mcp.storyos.dev/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "storyos": {
      "type": "http",
      "url": "https://mcp.storyos.dev/mcp"
    }
  }
}

Instalado en tu computadora

Claude Code

claude mcp add --scope user storyos --env STORYOS_TOKEN=your-value -- npx -y @storyos/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "storyos": {
      "command": "npx",
      "args": [
        "-y",
        "@storyos/mcp"
      ],
      "env": {
        "STORYOS_TOKEN": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "storyos": {
      "command": "npx",
      "args": [
        "-y",
        "@storyos/mcp"
      ],
      "env": {
        "STORYOS_TOKEN": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "storyos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@storyos/mcp"
      ],
      "env": {
        "STORYOS_TOKEN": "your-value"
      }
    }
  }
}

Valores que debes completar

  • STORYOS_TOKEN secreto obligatorio env
    Token de API personal de StoryOS (mn_pat_...), creado en API tokens dentro de StoryOS. Limitado a un solo espacio de trabajo.
    Ver original en inglésStoryOS personal API token (mn_pat_...), created under API tokens in StoryOS. Scoped to one workspace.
  • STORYOS_URL env
    URL base de la API de StoryOS, por ejemplo https://app.storyos.dev para la nube. Si no se define, el servidor usa http://localhost:3001 (desarrollo local).
    Ver original en inglésBase URL of the StoryOS API, for example https://app.storyos.dev for the cloud. When unset the server uses http://localhost:3001 (local development).
  • STORYOS_MCP_PROFILE env
    Establézcalo en internal para exponer también el perfil de herramientas interno. Déjelo sin definir para usar las herramientas predeterminadas.
    Ver original en inglésSet to internal to also expose the internal tool profile. Leave unset for the default tools.
  • WEB_URL env
    URL base de la aplicación web de StoryOS, utilizada para construir enlaces en los resultados de las herramientas. Si no se establece, el servidor usa http://localhost:3000
    Ver original en inglésBase URL of the StoryOS web app, used to build links in tool results. When unset the server uses http://localhost:3000.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Estrellas de GitHubi
8 (Estrellas de todo el repositorio)
Este repositorio tiene varias fichas MCP; sus estrellas cuentan una sola vez en las clasificaciones
Descargas por semanai
8/sem
Dominio verificado
✓ storyos.dev
Licenciai
Sin licencia indicada
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.1.2
Categoríai
Otros
Publicado en el registroi
19 nov 2026
Último cambio de códigoi
19 nov 2026
Última revisión
19 nov 2026
Creador
StoryFunnels
Paquetes
npm: @storyos/mcp
Sitio web
storyos.dev
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

El servidor pide iniciar sesión antes de mostrar sus herramientas.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con el dominio storyos.dev (el registro comprueba quién es dueño del dominio)

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: ayer

  • ! Precaución

    Tiene licencia

    GitHub no pudo identificar el tipo de licencia; abre el archivo para comprobarlo

  • ✓ Superada

    El endpoint responde

    Respondió en 547 ms (HTTP 401)

  • ✓ Superada

    Inicio de sesión con OAuth

    Declara inicio de sesión con OAuth, así que tu app de IA puede llevarte a iniciar sesión

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para @storyos/mcp@0.1.2

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 19 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/storyos.svg)](https://mcp.popnx.com/en/servers/storyos)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Otrosi

  • Más estrellas que el 91% de los otros 20815 servidores de esta categoría
  • Publicado en el registro más recientemente que el 98% de los otros 20815 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 60% de los otros 20815 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro StoryOS?

Superó 4 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: STORYOS_TOKEN

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez ayer, y la última versión (0.1.2) llegó al registro ayer.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

de koala73Muy usado★ 90,9 milActualizado hace 4 días

Se ejecuta en la nube✓ del servicio · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

de openstatusHQMuy usado★ 9,3 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

de JanDeDobbeleerMuy usado★ 23,8 mil Estrellas de todo el repositorioActualizado hace 31 días

Se ejecuta en la nube✓ del servicio · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

de Klavis-AIEn crecimiento★ 5,8 milActualizado hace 14 meses

Se ejecuta en la nubeRepo archivado✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

de jitsucomMuy usado★ 5,1 milActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · jitsu.com
Comparado con otros parecidos
Este
StoryOS
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Dónde se ejecutaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas4/54/44/44/41/44/4
LicenciaNOASSERTIONAGPL-3.0AGPL-3.0MITApache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

@storyos/mcp

The StoryOS Model Context Protocol server — it exposes your StoryOS workspace to AI agents (Claude first; ChatGPT-compatible by design). It's a thin, stateless translator over the same /api/v1 the web app uses, so it can never drift from the product, and every response is scoped and validated server-side.

Design + roadmap: docs/product/mcp-plan.md. Ticket: MN-076.

Tools

Read

ToolWhat it does
get_startedOrientation + a workspace map; with section it returns one reference section (the filter cheat-sheet, icons, working notes, a tool's full notes).
list_workspacesWorkspaces the token can access.
list_databasesDatabases in a workspace.
describe_databaseA database's schema — exact api_names, types, options, relation targets: what a write is keyed by.
searchFull-text record search — turn a name into a real id.
query_recordsFilter / sort / paginate records (structured filter AST).
get_recordOne record in full, by uuid or public number.
get_linksWeb-app URLs for a database, its saved views, and/or a batch of records — without a round-trip per record.

Write (each returns the resulting record; each 422 is surfaced verbatim)

ToolWhat it does
create_recordCreate a record; values by api_name, selects accept the label, relations accept an array of target numbers/ids (linked in the same write).
update_recordMerge-update (null clears); record by uuid or public number. Naming a relation sets it to exactly those targets.
delete_recordTrash a record (restorable 30 days).
link_recordsLink a record to targets through a relation field. replace: true sets the link set to exactly targets — how you re-point or clear a one-to-many link.
unlink_recordsRemove specific links from a relation field (the relation itself stays).
add_commentPost a comment.
attach_fileAttach a file to a record — from a public url (fetched server-side) or inline content_base64; images get a thumbnail.
list_attachments / delete_attachmentList a record's files, or remove one by id.
run_buttonPress a button field, running its automation actions.

Build / schema (agents design the workspace, not just fill it)

ToolWhat it does
list_spaces / create_spaceList / create spaces (a space holds databases).
create_database / update_database / delete_databaseCreate, rename/move, or delete a database (delete needs confirm = name).
add_field / update_field / delete_field / change_field_typeManage fields; select options by label; convert a field's type (dry_run to preview).
create_view / update_view / delete_viewManage views; accepts group_by / card_fields / date fields plus filters + sorts.
create_relation / delete_relationLink two databases (one_to_many / many_to_many) — paired relation fields.
reorder_fields / reorder_viewsSet field / view order by name.

Skills (a workspace's saved skills, over MCP)

ToolWhat it does
list_skillsSkills visible to the caller — their own personal ones, plus every shared one (same visibility rule the in-app Skills list enforces).
run_skillResolve a skill's instructions/when_to_use by name or id, and record the run (last_run_at/last_run_status). The call invokes no model, so you — the connected agent — carry out the instructions against the inputs you pass; they're echoed back, not executed server-side (an agent set to "StoryOS AI" can have the skill named in its Skills field instead).

A workspace's skills are also exposed as native MCP resources and prompts, for clients that understand those primitives (not just tools):

  • Resources: a storyos-skill://{workspace}/{skill} template. resources/list returns one entry per visible skill (across every workspace the token can see); reading one returns the skill rendered as portable Markdown — the exact shape GET /skills/:id/export?format=markdown produces.
  • Prompts: one named prompt per visible skill (e.g. skill_weekly_status_digest), disambiguated by workspace name on a name collision. prompts/get returns the skill's instructions as a single user-role message, ready to paste into context.

Both are read-only and best-effort: a catalog fetch failing for one workspace never blanks out another's, and a failure registering them never breaks the tools (see server.ts).

Automations (build a complete workflow — admin-scoped, #334)

ToolWhat it does
list_automationsThe rules on a database — each with its trigger (field/relation names resolved), condition, actions, enabled state, failure streak and last-run status.
get_automationOne rule's full, editable definition — human-readable database/field/select names alongside their stable ids — ready to feed back into update_automation.
create_automationCreate a rule = trigger (record_created / record_updated / record_linked / schedule / webhook_received) + optional condition (a query_records-style filter) + 1–10 actions (set_values / create_record / add_comment / notify_user / update_linked / send_slack_message / send_webhook / send_email / http_request / run_agent). Field/relation/person names and select labels resolve server-side; the in-app validator (AutomationActionsService.validate) validates the whole rule, so a bad reference comes back as a structured error, not a 500.
update_automationRename, enable/disable, or replace a rule's trigger / condition / actions — every field optional, re-validated the same way.
delete_automationDelete a rule (requires confirm=true); reports the removed rule's name, trigger and action summary.

Automations are an admin surface (the API is @RequiresScope('admin') and creator-gated), so all five tools are advertised only to an admin-scoped token — a read- or write-scoped PAT never sees them and therefore can never mutate a rule. These tools call the same endpoints the in-app RuleEditor does; there is no parallel validation path. Diagnose why a rule did (or didn't) fire with get_runs.

Conveniences: query_records / get_record return select values as labels (not option ids) and rich_text as Markdown; create_record / update_record accept Markdown on a rich_text field (headings, lists, links, code → parsed to blocks) and select labels; create_record reports any unset template fields. get_record / query_records / create_record / update_record all include a url — a clickable web-app link for that record — so an agent never has to describe a manual navigation path.

Hosted Streamable HTTP (for ChatGPT / claude.ai connectors without a local process) is the remaining phase — it lands with the cloud tier (see MN-069).

Light enough for capped clients (ticket #1262)

Every listed tool description is billed on every request of every session, so the listing is kept small: under 60,000 characters in total and no description over 1,500 (src/tool-description-budget.test.ts enforces both against the live registry). A description in the source can be as long as the tool needs; tools/list carries a short lead plus [Full notes: get_started section "TOOL NOTES "] (the one canonical pointer format, double quotes), naming the exact section. get_started with no argument returns only the overview and an index of section names (under 10,000 characters, so no client truncates it); get_started with section set to a name from that index returns that one section: the full text of one tool (the long reference grammars are TOOL NOTES create_automation, install_pack, add_field, create_source), FILTERS, ICONS or WORKING NOTES. Matching is exact first, then case-insensitive; an unknown name returns a text answer listing the valid names. One 85,000-character result was the alternative, and a client that truncates a single result would have silently dropped the grammars. A section is only loaded when called, so it costs a capped client nothing up front (src/get-started-sections.test.ts checks every lead points at a section that exists). Where a lead must say something at call time, it is hand-written with a short: key next to the description. The agent-run profile (?profile=agent-run, the Runner's runs) offers get_started too, because parameter hints (FILTERS, ICONS) name it, but keeps every description WHOLE (WHOLE_DESCRIPTION_PROFILES in src/tool-profiles.ts): its 9 tools total about 3k characters, only ~1k more than leads would cost, and a lead is a round trip. src/profile-pointers.test.ts checks, for every profile, that a pointer names a tool the profile offers and a section its own index lists.

Maintainer-only tools (get_branch_name, get_pinned_tabs, set_pinned_tabs, get_dismissed_hints, set_dismissed_hints, list_icon_set; INTERNAL_TOOLS in src/tool-profiles.ts) are not offered on any customer connection. They appear with ?profile=internal over HTTP, or STORYOS_MCP_PROFILE=internal for a stdio server. The icon names list_icon_set used to return are in get_started section ICONS.

Descriptions state facts and references, never instructions (ticket #1288)

The Claude connector directory policy for tool metadata is that a description contains no instructions about model behaviour or other tools. A tool description says what the tool does, takes and returns; it may state a product fact and carry a neutral reference (See also: describe_database, [Full notes: get_started section "TOOL NOTES "]). Guidance for the model (look at the schema before writing, count with count_records, do not retry a held write, ...) lives in get_started section WORKING NOTES, which is a tool RESULT and not a description. src/tool-description-policy.test.ts enforces this against the live registry: every tool description and every parameter description, on every profile, is scanned for imperatives about another tool, sequencing words around a tool name, "read this before"-style calls to action and behavioural instructions (FORBIDDEN_PATTERNS), with self-tests and an explicit ALLOWED_PHRASES list that needs a reason per entry.

Why it doesn't hallucinate

  • Schema-first: describe_database gives exact api_names; you read before you write.
  • Validation-as-teacher: the API's typed error is surfaced verbatim, so a wrong field/value comes back naming the problem and the model self-corrects in one turn.
  • Structured filters, not a query language: nothing to invent; the op×type matrix ships in get_started section FILTERS.
  • Never invent ids: they come only from search / list_* / a prior result; names and slugs are accepted and resolved server-side.

Configure

1. Get a token — in StoryOS, sidebar → API tokens → create one for the workspace you want. Copy the mn_pat_… (shown once; scoped to that workspace). Without this, the server starts and immediately exits with fatal STORYOS_TOKEN is required — that's the config check working, not a broken install.

2a. Claude Code

claude mcp add storyos \

-e STORYOS_URL=https://app.storyos.dev \ -e STORYOS_TOKEN=mn_pat_xxx \ -- npx -y @storyos/mcp

2b. Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

{

"mcpServers": { "storyos": { "command": "npx", "args": ["-y", "@storyos/mcp"], "env": { "STORYOS_URL": "https://app.storyos.dev", "STORYOS_TOKEN": "mn_pat_xxx" } } } }

STORYOS_URL is https://app.storyos.dev for the cloud box, or

Solo se muestra el principio; lee el resto en el repo