Skip to content

mcp.types.Tool is not following python's naming convention  #97

Closed
Closed
mcp.types.Tool is not following python's naming convention #97
Labels
P3Nice to haves, rare edge casesbreaking changeWill break existing deployments when updated without changesenhancementRequest for a new feature that's not currently supportedready for workEnough information for someone to start working onv2Affects the v2 line (2.x on main)
Milestone
Python SDK v2.0

Description

@santosflores
santosflores
opened on Dec 11, 2024

Describe the bug
The input schema property is not following the snake case convention. Currently the property is defined as "inputSchema" instead of "input_schema". Ideally we can follow the convention as it is widely adopted. Additionally, not following the convention requires more lines of code on the client when passing the available tools to the API request.

python-sdk/src/mcp/types.py

Line 660 in aaf32b5

inputSchema: dict[str, Any]

Expected behavior
inputSchema get renamed to input_schema

Screenshots
N/A

Activity

  1. azdolinski
    added a commit that references this issue on Dec 26, 2024

    Update types.py

    5b4f452
  2. dsp-ant
    added
    enhancement
    on Jan 3, 2025

  3. soohoonc commented on Feb 21, 2025

    @soohoonc
    soohoonc
    on Feb 21, 2025

    👍 this is very annoying

  4. Kludex
    added a parent issue on Aug 9, 2025
  5. Kludex
    added this to the Version 2.0 milestone on Aug 12, 2025
  6. felixweinberger
    modified the milestones: Version 2.0, Python SDK v2.0 on Oct 6, 2025
  7. felixweinberger
    added
    v2Affects the v2 line (2.x on main)
    code quality
    ready for workEnough information for someone to start working on
    P3Nice to haves, rare edge cases
    on Oct 6, 2025
  8. felixweinberger
    added
    enhancementRequest for a new feature that's not currently supported
    and removed
    code quality
    enhancement deprecated
    on Nov 12, 2025
  9. maxisbey
    added
    breaking changeWill break existing deployments when updated without changes
    on Dec 5, 2025

  10. maxisbey commented on Dec 8, 2025

    @maxisbey
    maxisbey
    on Dec 8, 2025
    Contributor

    Closing as duplicate of #1738, which proposes renaming all types.py fields from camelCase to snake_case. This specific case (inputSchema → input_schema) will be addressed as part of that broader effort.

  11. maxisbey
    closed this as completedon Dec 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    P3Nice to haves, rare edge casesbreaking changeWill break existing deployments when updated without changesenhancementRequest for a new feature that's not currently supportedready for workEnough information for someone to start working onv2Affects the v2 line (2.x on main)

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions