Skip to main content
Glama

独行录 / opcmenu

需求信息流

list_needs_feed

【何时用】用户想看「大家都在找什么」「有什么我能帮上/接得住的需求」时——这是需求互换的主入口。

【结构】一人一卡按作者聚合:每张卡是一位主理人(主打 author.canOffer「能提供什么」+ 代表产品),主需求平铺在卡上,authorNeeds 列出该作者在架需求(最多 6 条,主卡需求在首位)。登录后按「TA 的需求 ↔ 我的价值」轻个性化排序并附 matchScore/matchReason;匿名同管线纯先验排序。

【组合链】看中某人 → contact_need 该需求拿 conversationId → send_message 直接开聊。定向找用 search_needs / search_people。想让匹配更准就先补自己的 canOffer(update_my_profile)——排序就是拿它跟对方需求比的。

【口径】接洽不限人数,没有「名额」这回事,也没有报酬/感谢费——看到谁在找就直接聊。

【分页】cursor 原样回传延续同一副牌;不传 = 重新洗牌。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
typeNo按需求类型过滤:EXPERIENCE(寻找产品/作品) | QA(答疑求助) | RESOURCE(介绍资源) | COLLAB(寻求合作) | FINANCING(融资需求) | CHAT(找人聊聊找灵感) | GIG(兼职招募) | OTHER(其它);不传则全部
limitNo返回条数,默认 20
cursorNo分页游标 nextCursor,原样回传

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Even with annotations covering open-world/read-only/destructive hints, the description adds substantial behavioral detail: one-card-per-author aggregation, 6-need cap with the main need first, logged-in personalization with matchScore/matchReason, anonymous prior-only order, and cursor semantics distinguishing 'same deck' vs 'reshuffle'.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Uses compact section headers (何时用/结构/组合链/口径/分页) that front-load the decision-relevant use case and put pagination last. Every sentence carries operational value, with no filler or schema repetition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite no output schema, the description covers the return shape (per-author cards, canOffer, representative product, needs list), the sort behavior, follow-up tool routing, usage scope, and pagination contract. For a query tool with zero required parameters, this is sufficient for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema descriptions already cover all 3 parameters (100% coverage), so baseline is 3. The description earns extra by explaining cursor behavior beyond the schema: passing the cursor continues the same deck, omitting it reshuffles, which directly affects how an agent should invoke pagination.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description names a specific action and resource: the need-exchange feed where users see what people are looking for and what they can take on. It also differentiates from targeted siblings by naming search_needs / search_people as the 'targeted' alternative and contact_need/send_message as the follow-up path.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Opens with an explicit 'when to use' condition and gives clear exclusions: use search_* for targeted lookup, use update_my_profile to improve ranking, and use contact_need then send_message to act on a card. The '口径' section removes ambiguity about contact limits/fees.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources