Skip to content

feat: declare idempotency, describe tool outputs, answer the root with 200 - #48

Merged
fatwang2 merged 1 commit into
mainfrom
claude/project-thread-0q5iyb
Oct 23, 2026
Merged

fatwang2 merged 1 commit into
mainfrom
claude/project-thread-0q5iyb

Conversation

@fatwang2

Copy link
Copy Markdown
Member

Manufact's MCP catalog listed us at 93/100 (https://manufact.com/leaderboard/search1api). This PR addresses the deductions it reported:

  • Annotations: six tools had no idempotentHint. The billed tools now declare idempotentHint: false, because every call costs credits. render_results keeps true.
  • Tool docs:
    • The crawl, sitemap and trending descriptions now say what each tool returns.
    • The sitemap and trending output fields now have descriptions.
    • Some input field descriptions used to restate schema limits; they now explain how to use the field.
  • Declared widget domain: GET / on mcp.search1api.com used to 301 to s1.dev, which the scorer counted as "domain not responding". It now returns 200 with:
    • a canonical link (as both a header and a tag) pointing to s1.dev/mcp-server,
    • an instant meta refresh to s1.dev/mcp-server that keeps query parameters,
    • a visible fallback link.
  • Regenerated lhm.plugin.json (npm run sync:manifest).

Tests: npm test passes 46/46, including a new root-page test and an idempotency assertion.


Generated by Claude Code

…h 200

Manufact's MCP catalog scored 93 and deducted for: no idempotentHint on
the billed tools, crawl/sitemap/trending descriptions that did not say
what they return, field descriptions that restated schema limits, and
the declared widget domain answering with a 301 instead of responding.

- Billed tools declare idempotentHint: false (each call costs credits).
- crawl, sitemap and trending descriptions and output fields say what
  comes back; input descriptions explain usage instead of limits.
- GET / answers 200 with a canonical link and an instant meta refresh
  to s1.dev/mcp-server, keeping query parameters.
- Regenerated the LobeHub manifest.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SJGhGT4LDJjiEpCrQX6PW7
@fatwang2
fatwang2 merged commit fda1814 into main Oct 23, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants