Skip to content

Use underscore names for synthetic plan MCP tools - #164

Merged
nibalizer merged 2 commits into
mainfrom
nibz/no-ticket/underscore-plan-tool-names-clean
Jul 28, 2026
Merged

Use underscore names for synthetic plan MCP tools#164
nibalizer merged 2 commits into
mainfrom
nibz/no-ticket/underscore-plan-tool-names-clean

Conversation

@nibalizer

@nibalizer nibalizer commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • rename Atryum's synthetic MCP plan helpers from dotted names to atryum_plan_submit and atryum_plan_get
  • derive agent-facing initialize/tool descriptions from the shared helper-name constants so the advertised names cannot drift
  • add a regression test that fails if tools/list ever returns dotted synthetic tool names again
  • update related auth/plan tests and docs/examples to use the underscore names

Also includes a commit where I cleaned up messaging in some comments after discussing auth with amp.

Why

Anthropic/Claude rejects dotted tool names during tool registration, so the previous synthetic helper names (atryum.plan.submit / atryum.plan.get) could break MCP tool exposure even though they were otherwise valid MCP identifiers.

Testing

  • git diff --check -- README.md examples/codex-mcp/README.md internal/api/auth_test.go internal/api/handlers.go internal/api/handlers_test.go internal/invocation/local_evaluator.go internal/invocation/plan_service.go internal/invocation/plan_service_test.go
  • not run: go test / gofmt are unavailable in this container (go and gofmt not on PATH)

Rename Atryum's synthetic plan helpers away from dotted MCP tool names,
update the related runtime guidance and tests, and add a regression test
that fails if dotted synthetic tool names reappear in tools/list.

Co-authored-by: Amp <amp@openai.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019faa2d-bcae-7439-9d2e-a6672f07f7ca
Co-authored-by: Amp <amp@ampcode.com>
@nibalizer
nibalizer marked this pull request as draft July 28, 2026 20:01
Keep the calculator integration target on a compatible MCP Python
version line. mcp-server-calculator 0.1.1 still imports
mcp.server.fastmcp, which was removed in MCP 2.x, causing the direct
MCP smoke tests to fail with EOF after the helper venv resolved mcp
2.0.0.

Co-authored-by: Amp <amp@openai.com>
Amp-Thread-ID: https://ampcode.com/threads/T-019faa2d-bcae-7439-9d2e-a6672f07f7ca
Co-authored-by: Amp <amp@ampcode.com>
@nibalizer
nibalizer marked this pull request as ready for review July 28, 2026 21:33

@mdeyell-valid-mind mdeyell-valid-mind left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

makes sense

@nibalizer
nibalizer merged commit d75d16b into main Jul 28, 2026
4 checks passed
@nibalizer
nibalizer deleted the nibz/no-ticket/underscore-plan-tool-names-clean branch July 28, 2026 21:46
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