Skip to main content
Glama

独行录 / opcmenu

发消息圈

publish_moment

【需要登录】以用户名义发一条消息圈:文字 + 最多 9 张图 + 可选挂一张站内卡片(活动 / 产品 / 需求 / 组织)。关注 TA 的人、同组织与需求匹配的人会看到,内容也会进撮合匹配。 【组合链】用户在对话里发来的图,地址直接放进 images;外部图片先 upload_image_from_url(kind=moment-image);头像、产品图等别处的图不收,要带就挂卡(我的活动 / 产品 / 需求 / 组织 id 从 list_my_activities / get_my_products / list_my_needs / list_my_organization_memberships 拿)。 【注意】对外发布、只能删不能改:正文只用用户说过的话,发前念给用户确认。visibility 不传 = 公开。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
imagesNo图片地址,最多 9 张,按顺序展示
contentNo正文(纯文本,最多 2000 字)
attachIdNo挂卡对象 id(活动也可传 slug);与 attachType 成对
attachTypeNo挂卡类型:activity 活动 | product 产品 | need 需求 | organization 组织;与 attachId 成对
visibilityNopublic 公开(缺省,所有登录用户)| friends 仅互相关注的好友 | private 仅自己

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.6/5.0
Behavior5/5

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

Annotations cover writability and openness, but the description adds information the annotations cannot: a login requirement, the actual audience distribution, that content feeds matching, that the publish is public-facing, and critically that the post is immutable ('只能删不能改'). This is exactly the beyond-annotation context the dimension rewards, and it is consistent with readOnlyHint=false, idempotentHint=false and destructiveHint=false.

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

Conciseness4/5

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

The three bracketed sections 【需要登录】【组合链】【注意】 front-load the highest-risk facts (auth, image sourcing, immutability) and keep each paragraph dense with no filler. It is on the long side for a five-parameter tool, but every sentence carries operational content.

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?

For a non-idempotent publish tool with no output schema, the description closes every gap an agent needs to act safely: auth, accepted content types, the upstream tools that supply image and card ids, the audience, the default visibility, and the confirm-before-send etiquette. Return values are the only omission, and no output schema exists to require them.

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 coverage is 100%, so 3 is the baseline, and the description earns a bump by explaining where attachId values legitimately come from and that attachId/attachType must be supplied as a pair, plus restating that omitting visibility means public. It does not deepen the content/images limits beyond what the schema already states, so it is not a 5.

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?

States a specific verb and resource (以用户名义发一条消息圈) and enumerates exactly what the post can contain: text + up to 9 images + one optional in-site card (activity/product/need/organization). The audience sentence ('关注 TA 的人、同组织与需求匹配的人会看到,内容也会进撮合匹配') separates it from siblings like comment_moment, like_moment, or delete_my_moment without any need to open another schema.

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

Usage Guidelines4/5

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

Gives concrete routing guidance for the composable steps: conversation-supplied image URLs go straight into images, external images must first pass through upload_image_from_url(kind=moment-image), and card ids come from list_my_activities / get_my_products / list_my_needs / list_my_organization_memberships. It also states a when-not ('头像、产品图等别处的图不收'). What it lacks is an explicit statement of when to choose this tool over adjacent publish/send tools, so it stops short of a full 5.

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