Stoory MCP Server
Hire a human specialist from your AI workspace — without leaving it.
AI can build most of your app. It can't get you GDPR-compliant, review your
Stripe integration, design your landing page, or run your SEO. Stoory MCP lets
your AI coding assistant find, brief, and hire the right human for that —
without you ever opening Upwork, writing a job post, or explaining your
problem from scratch.
What it does
- Search Stoory's marketplace (430+ specializations: dev, legal, design,
growth, operations) with a natural-language query.
- Package a task: your AI assistant drafts the title, description, and
budget, and attaches only the files the specialist actually needs — shared
by link or uploaded to the task, never your whole repo.
- Hand off safely: files are attached privately to the task on Stoory,
visible only to the invited specialist — no repo to create or manage.
- Track progress: one call returns the whole task — status, budget,
deadline, the invited/accepted specialists, and every file (yours plus
whatever the specialist delivers) pulled back into your AI workspace.
You stay in control of the two decisions that matter — who to hire and
what budget to approve. The agent does the rest.
See Tools below for the full list.
Quickstart
Requirements
- Any AI client that supports MCP over Streamable HTTP (Claude Code, Claude
Desktop, Claude.ai, Cursor, Windsurf, VS Code, Codex CLI, Replit, Lovable,
...).
- A free Stoory client account and API key (below).
1. Get a client API key
Sign up at
stoory.io/login?step=register&u=Client_(user),
then open MCP Server on the Stoory homepage to generate your
client_api_key.
2. Add the server to your AI client
Pick your client below. The URL is always https://mcp.stoory.io/mcp, the
header is always x-api-key, but where you put them differs per client.
Claude Code
claude mcp add --transport http stoory \
https://mcp.stoory.io/mcp \
--header "x-api-key: YOUR_API_KEY_HERE"
Or add directly to .mcp.json:
{
"mcpServers": {
"stoory": {
"url": "https://mcp.stoory.io/mcp",
"headers": { "x-api-key": "YOUR_API_KEY_HERE" }
}
}
}
Claude Desktop / Claude.ai
Settings → Connectors → Add custom connector. Paste
https://mcp.stoory.io/mcp as the URL, open Request headers, add
x-api-key with your key, then click Add.
(Request header auth is currently rolling out at Anthropic. If you don't see
a "Request headers" option yet, use Claude Code or another client below in
the meantime.)
Cursor
Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"stoory": {
"url": "https://mcp.stoory.io/mcp",
"headers": { "x-api-key": "YOUR_API_KEY_HERE" }
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json — note the field is
serverUrl, not url:
{
"mcpServers": {
"stoory": {
"serverUrl": "https://mcp.stoory.io/mcp",
"headers": { "x-api-key": "YOUR_API_KEY_HERE" }
}
}
}
VS Code
Add to .vscode/mcp.json — note the root key is servers, not
mcpServers, and each entry needs "type": "http":
{
"servers": {
"stoory": {
"type": "http",
"url": "https://mcp.stoory.io/mcp",
"headers": { "x-api-key": "YOUR_API_KEY_HERE" }
}
}
}
Codex CLI
Add to ~/.codex/config.toml:
[mcp_servers.stoory]
url = "https://mcp.stoory.io/mcp"
http_headers = { "x-api-key" = "YOUR_API_KEY_HERE" }
Replit
Replit connects MCP servers at the account level — added once, available
in every project. Open Settings → MCP Servers, click + Add MCP
server, then:
- Name it
stoory.
- Paste
https://mcp.stoory.io/mcp as the server URL.
- Open Advanced settings and add a custom header
x-api-key with your
key.
- Click Test & save.
Lovable
Open Settings → Connectors, and under Personal connectors click
Custom. Paste https://mcp.stoory.io/mcp as the remote MCP server URL and
click Add.
(Lovable's custom connector currently authenticates via OAuth only. If there
is no field for a custom x-api-key header, header-key auth isn't available
in Lovable yet — use Claude Code or another client above in the meantime.)
3. Ask for help
"My AI assistant keeps breaking my Stripe integration. Find me someone who can fix it."
That's it — the assistant searches, drafts the task, shows you cost and
files before anything is sent, and waits for your go-ahead.
| Tool | What it does |
|---|
search_specialists | Semantic search over Stoory's specialist marketplace |
create_task | Drafts and sends a task to one or more chosen specialists (requires explicit user confirmation) |
get_task | Returns the whole task record — status, invited/accepted specialists, budget, deadline, and files (your context files plus whatever the specialist delivers) |
cancel_task | Cancels a task before a specialist has accepted it |
How it works
"I need a GDPR specialist"
│
▼
AI searches the marketplace, you pick a specialist
│
▼
AI drafts the task + selects only the needed files
│
▼
You confirm cost and file list
│
▼
Task created on Stoory, files attached privately, specialist invited
│
▼
You pull the result back into your AI workspace
Security & privacy
Your private data doesn't need to become public just because you need
human help.
- Your assistant chooses which files to share — never the whole repo.
- You pass those files as a link or a direct upload — the server has no
access to your disk and never reads local paths.
- Attachments are stored privately on the task, visible only to the
invited specialist.
- Files are scanned for secrets (
.env, private keys, API keys/tokens) on
the server before they're stored.
- Nothing is shared, and no task is created, without your explicit
confirmation.
Example
User: "I've built my SaaS with AI. I need a privacy policy
and terms of service before I can launch."
AI: 5 relevant specialists found.
User: "Use #2, budget $200."
AI: Creates the task, writes the brief, selects the relevant
project files, attaches them privately to the task, and
invites the specialist. Done.
- Marketplace & signup: stoory.io
- Issues / bugs: GitHub Issues
- MCP Registry entry:
io.github.StooryBot/stoory-mcp
Are you a specialist?
Stoory MCP recommends specialists from Stoory's marketplace to clients —
if you're a developer, designer, lawyer, marketer, or any other freelancer,
a free profile makes you eligible to get invited. No commission, ever.
Create your free profile at stoory.io/for-specialists.
Disclaimer
Stoory MCP does not replace your AI assistant and does not perform payments
or hiring decisions on its own — it prepares the task and hands the decision
to you. Stoory does not process payments: client and specialist settle
payment for the work directly between themselves, entirely outside Stoory.