Stoory Hire Specialist

io.github.StooryBot由 GitHub 账号 StooryBot 发布v0.1.0更新于 Oct 25, 2026

Find and hire a human specialist from the Stoory marketplace, right from chat.

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

让 AI 助手在 Stoory 市场搜索真人专家,起草并发送带预算的任务、跟踪进度,并在专家开工前取消任务。

可以做什么
用自然语言查询在 Stoory 市场搜索真人专家,命中过少或仅有备选匹配时可放宽查询重试。起草任务并发送给一位或多位选定专家,包含标题、描述、预算和截止时间,只附带选定的文件(链接或上传)。获取完整任务记录:状态、预算、截止时间、时间线、受邀与已接受专家以及附件。在专家尚未开始工作前取消任务。
适用场景
当项目需要助手无法提供的人类专业能力时使用,例如法律或隐私合规审查、支付集成修复、设计或 SEO 工作,并希望不离开对话就找到、说明并跟踪专家。
运行要求
一个可通过 Streamable HTTP 访问的远程 MCP 端点,需由支持 MCP 的客户端连接。免费的 Stoory 客户账户和客户端 API 密钥,通过 x-api-key 请求头发送。需要访问 Stoory 服务的网络连接。
安装前请注意
API 密钥代表你的账户身份,必须保密。创建任务会把任务说明和你附带的文件发送到 Stoory 及受邀专家,确认前请核对文件清单和预算;服务器会扫描附件中的密钥信息,但仍应避免共享敏感文件。创建任务需要用户明确确认。Stoory 不处理付款,你需在平台之外与专家直接结算。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Stoory Hire Specialist,将其添加到工作区。
  2. 连接 x-api-key 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.StooryBot%2Fstoory-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "stoory-hire-specialist": {
      "type": "http",
      "url": "https://mcp.stoory.io/mcp",
      "headers": {
        "x-api-key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

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
bash
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:

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):

json
{  "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:

json
{  "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":

json
{  "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:

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:

  1. Name it stoory.
  2. Paste https://mcp.stoory.io/mcp as the server URL.
  3. Open Advanced settings and add a custom header x-api-key with your key.
  4. 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.


Tools

ToolWhat it does
search_specialistsSemantic search over Stoory's specialist marketplace
create_taskDrafts and sends a task to one or more chosen specialists (requires explicit user confirmation)
get_taskReturns the whole task record — status, invited/accepted specialists, budget, deadline, and files (your context files plus whatever the specialist delivers)
cancel_taskCancels 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.

Community & support

  • 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.

来源:README.md,提交 aaa6c67

工具

4

search_specialists

Search specialists

Searches for specialists in the Stoory marketplace via semantic search. Result quality depends mostly on a well-built `query` — see the `query` field description. If a result has <3 hits or only 'Alternative fit', retry with a simpler/broader query (see `query`) instead of asking the user; only after about 3 failed attempts tell the user you have no one to recommend for these requirements and suggest widening the criteria.

输入参数limitquery必填countrylanguagesgeo_location

create_task

Create task

Invites one or more chosen specialists to a project — does NOT charge payment. budget is a single amount for the whole task (not multiplied per specialist) — whoever accepts it does the work for it. Requires user_confirmed=true, set only after the user has explicitly confirmed in the conversation the choice of specialists, the list of shared files and the estimated cost. Estimate budget yourself from the problem's complexity (e.g. 1h = a single well-localized bug / a simple document fix / a minor graphic tweak; 2h = a standard debug across a few files / a draft legal document (e.g. Privacy Policy) / a landing page design; 3h = an architecture review, a full legal package (ToS+Privacy+GDPR) or a compliance audit, full branding, no clear diagnosis) times the specialist's min_rate_per_hour (from search_specialists) — this field is informational, not enforced, always in USD (the only currency on the marketplace).

输入参数title必填budget必填language必填timelinedescription必填context_filesspecialist_ids必填user_confirmed必填problem_context必填

get_task

Get task

Returns the whole task record in one call — use it both to check progress and to read the result. Fields: status, title, desc, budget, deadline, timeline, created, modified; specialist_invited and specialist_accepted (arrays of { id, profile_url } — profile_url is already in the right language, show it to the user as a link, not a bare id); and `files` — URLs of every file attached to the task on Stoory (the client's context files plus whatever the specialist delivers). Call it again when the user asks about progress. create_task already returns attached_files for the files it uploaded.

输入参数task_id必填

cancel_task

Cancel task

Cancels the task, as long as the specialist has not started work yet.

输入参数task_id必填

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。