Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Tool descriptions do not tell an agent when to stop

クローズ
  • 何か問題がありますか？
#424 コメント 4 件 リアクション 0 件 担当者 1 名 GitHub で見る

メンテナーはふだん 3 日以内に返信

@rupesh-kumar-sah がすでに取り組んでいます。

2026年10月17日 から。

  • #435 @sparkysolutions10-pixel による — オープン
  • #445 @rupesh-kumar-sah による — オープン

評価

この issue はまだ評価されていません。

説明

area:mcp difficulty:easy help wanted points:100 Stellar Wave
Background
'Search for resources in a Stellar Bazaar node'
'Make a paid API call to a Bazaar resource, handling the 402 loop automatically.'

A tool description is the only instruction an agent gets. The second one says
payment is handled automatically and says nothing about cost, limits, or the
fact that real funds move — so an agent reasoning about whether to call it has
no basis to hesitate, and "automatically" actively encourages it not to.

The descriptions also do not say what the tools cannot do, which is what stops
an agent calling the wrong one repeatedly.

What to build
  • Rewrite both descriptions to state what the tool does, what it costs, what it
    requires, and when not to use it.
  • paid_call must say that it spends real funds and name the per-call limit.
  • Describe each argument in its schema, including the format expected.
  • Where L209's allow-list exists, say that only permitted hosts can be paid — an
    agent that knows the rule will not waste turns discovering it.
Acceptance criteria
  • Each description states purpose, cost and preconditions
  • paid_call explicitly says real funds move, and names the limit
  • Every argument has a description and a stated format
  • Descriptions say when not to use the tool
  • No description promises behaviour the code does not implement

Drips Wave · Complexity: Easy · 100 points

Repo: Divinity-Labs/Lens. The MCP server is src/mcp/server.ts
(BazaarMcpServer) with error codes in src/mcp/codes.ts. It is started by
npm run mcp:server → examples/mcp-server/run.ts, and there is an agent
example at examples/mcp-server/agent.ts. Tests are tests/mcp.test.ts.

Run the tests: npm test. The tests are vitest, not jest. A single file
is npx vitest run tests/mcp.test.ts.

Load test (prices) is already failing on main. Not your PR.

This surface signs with a real mainnet key. examples/mcp-server/run.ts
requires MCP_AGENT_SECRET_KEY_MAINNET and builds a signer for
stellar:pubnet. Anything you change here can move real money, so prefer
failing closed, and never log, echo or test with a real secret key.

Never elide an address, a contract id or a key in code, comments or
fixtures. A previous batch shortened a contract id and five contributors
invented plausible-looking ids to fill the gap. Write it in full or not at all.

An agent is the least able caller to notice a wrong answer. It will reason
over whatever it is handed, confidently. Prefer a structured error over a
best-effort result.

Required: Before submitting, join the contributor Telegram so your work can be tracked and counted toward the Stellar Wave: https://t.me/+fxHXq8f1SwlkZDBk

主要言語
TypeScript
スター
4
フォーク
71
平均マージ
3日 6時間
マージ済み PR（30日）
144

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

Divinity-Labs/Lens のほかの issue

Divinity-Labs/Lens の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。