Revelica
com.revelicaPublished by revelica.comOfficial publisherv1.0.0Updated Nov 2, 2026
Product intelligence for AI agents — query a Revelica workspace's ideas, specs, and research.
Overview
Remote Revelica MCP server that lets an assistant query, read, create and update product ideas, specs and research in a Revelica workspace.
- What you can do
- Search and filter workspace artifacts by criteria, with ranked matches and schema templates
- Read a single artifact or entity in full, or navigate a subtree by dotted field path
- Create new artifacts and entities, validated against registered schemas
- Apply partial field-level updates using dot-path notation
- List and load server-side product workflow skills, such as planning toward a goal, framing bets, writing specs or analyzing customer interviews
- When to use it
- Useful for product teams that keep customer research, competitive analysis, goals, bets and specs in Revelica and want an agent to read that context and add new evidence or plans to it. It fits workflows like turning an interview transcript into a snapshot, planning work toward a goal, or saving a URL, file or note as product evidence.
- Requirements
- A Revelica workspace account. The server is a remote Streamable HTTP endpoint with OAuth 2.0 and dynamic client registration, so no API key is needed; the client must support OAuth. Plugins are shipped and tested only for Claude and OpenAI hosts, though other Streamable HTTP clients can connect directly.
Installation
In SourceWeft
- Open Revelica in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/com.revelica%2Frevelica/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"revelica": {
"type": "http",
"url": "https://api.revelica.com/mcp"
}
}
}README
Revelica Skills
Revelica's plugin package connects an agent to shared product context: customer research, competitive analysis, goals, bets and product specs. It declares the Revelica MCP server, a setup skill and three starting skills. The full workflows live on the server, which names the one for each job in its instructions and loads it with load_skill.
There is one plugin, plugins/revelica/, with a manifest for each host beside it. Each host's catalog sits at the repository root, where that host looks for it. Installation and OAuth support depend on the client.
Repository Structure
Installation by Platform
Claude Code
The plugin bundles the starting skills and the MCP server configuration. Authorize the server connection in your client before using workspace tools.
Cowork
Add https://api.revelica.com/mcp as a custom connector in your organization's
settings. The server's instructions name the skill for each job, and list_skills lists the rest.
Codex
In ChatGPT, install Revelica from the plugin directory once it is listed.
Other clients
Cursor, Gemini CLI and any other client that speaks Streamable HTTP with OAuth can connect the server directly (see Connecting the MCP Server Directly). We only ship and test plugins for Claude and OpenAI hosts. Release 1.10.1 removed the Cursor and Gemini manifests, which nobody was testing.
Starting prompts
The plugin adds a setup skill and three starting skills, the same starting points the Revelica app offers. In Claude Code each is also a slash command:
What the plugin connects to and sends
The plugin runs no code on your machine. It declares one remote MCP server, https://api.revelica.com/mcp (Streamable HTTP), and bundles Markdown skills that start common work with it.
- Sign-in: OAuth 2.0 with dynamic client registration, handled by your client. The plugin reads no credentials, tokens or files from your machine.
- What it sends: the tool calls your agent makes (
query,read,create,update,load_skill,list_skills) and their arguments, which carry the product data you ask it to save to your workspace. - What it receives: records from your own Revelica workspace, and skill instructions.
Nothing else is sent anywhere. See Privacy Policy for how Revelica handles your data.
Available MCP Tools
These tools are provided by the Revelica MCP server and callable from any skill:
All tools require OAuth authentication and enforce Supabase row-level security, so users only see their own workspace's data.
Skills
The product workflows are skills on the connected Revelica MCP server: drive-product-outcome, frame-bet, write-product-spec, design-experiment, product-for-coding-agents and others. The server's instructions say which one fits which job, and list_skills shows the full catalog for the connected user.
An Idea is the product spec. Its story map, structured document and Markdown are representations of the same spec.
Loading a skill lets the current agent follow the workflow using the available tools; it does not start a server-side playbook. These tool-based workflows do not require a host to implement the skills-over-MCP extension.
Updating
Product workflow instructions live on the Revelica server, so the app and connected agents discover the same canonical workflow. The package's four skills share the names and descriptions of the server skills they start, and load the full workflow from the server with load_skill, so the workflow and the workspace readiness it reports are always current. Release 1.9.0 removed the bundled use-revelica and product-for-coding-agents routers: every supported Claude host shows the server's instructions, which carry the same routing.
Release 1.10.0 moved the plugin into plugins/revelica/, turned the commands into skills so every host can use them, and added the OpenAI manifest. Bump the version in every manifest together, including server.json, and the
SERVER_VERSION constant the MCP server reports (revelica_agents/app/mcp_server/server.py in scryfast). Name releases Revelica X.Y.Z and
list the targeted platforms in the release notes. Versions belong to Revelica
across hosts; platform-specific changes share that version. For example, Revelica
1.10.4 adds Codex plugin metadata and portable packaging for Codex and ChatGPT.
Package updates and server deployments are separate. A newly documented server workflow must be deployed before a connected client can load it. Installing this package does not deploy server changes.
Run bash scripts/package-openai.sh to build dist/revelica-openai-<version>.zip
for OpenAI's submission portal. It exports the Codex manifest's listing fields
under extensions.com.openai.interface in a portable root plugin.json, and
exports .mcp.json as mcp.json with the Streamable HTTP transport name. Review
cases and publication metadata are retained. The shared plugin's Claude and
Codex compatibility manifests are not included in this public upload.
Package validation does not complete the portal's reviewer access, demo,
country targeting, scans, or attestations.
The exporter refuses to overwrite an existing archive. For a verification build,
choose a new path: bash scripts/package-openai.sh --output /tmp/revelica-check.zip.
ZIP entry timestamps and permissions are fixed, so builds with the same
Python/zlib toolchain produce identical bytes. Run the packaging checks with
python3 -m unittest discover -s scripts/tests -v.
Keep one private copy of the exact ZIP uploaded for review. dist/ stays ignored.
Reviewer account details, recordings and submission notes belong outside this
public repository. The public manifest contains reusable test cases; supply
submission-specific workspace instructions and recording metadata privately when
preparing an upload. A fresh export is not a replacement for the original upload.
The skills in plugins/revelica/skills/ carry the name, description and starting prompt of the server skill with the same name (scryfast revelica_agents/app/agents/revelica/skills/). Keep them in step when those change.
Connecting the MCP Server Directly
If you'd rather connect the server without the plugin, add it as a remote MCP server / custom connector:
Server metadata is published at
/.well-known/mcp/server-card.json.
Privacy Policy
Revelica's privacy policy covers what data is collected, how it is used and stored, third-party sharing, retention, and how to contact us. It is published at revelica.com/privacy. Terms of service are at revelica.com/terms.
The MCP server reads and writes only the product data in your own Revelica workspace. Every request is authenticated with OAuth and enforced by Supabase row-level security, so a connected agent can never see another workspace's data. The server does not query your chat history, conversation summaries, or files.
Support
-
Reviewing the plugin for a directory: see REVIEWING.md
-
Issues with the plugin: open a GitHub issue
-
Account, workspace, or MCP server issues: [email protected]
License
Apache-2.0 © Revelica
About Revelica
Revelica is an AI-native product discovery platform. It helps product teams gather customer insights, perform competitive analysis, and experimentally validate ideas that feed into their AI development workflow.
🔗 Homepage with free Pro trial: https://revelica.com
🔗 Template library with playbooks, skills, and insight templates: https://revelica.com/templates
🔗 Free AI tools with no signup required: https://revelica.com/tools
Source: README.md at commit 372969e
Tools
0Version history
1- v1.0.0LatestSep 16, 2026
Score
85% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts