feat(agentgateway): add mcp tools filtering

[jplbrun]

Disclaimer: Do not include SAP-internal or customer-specific information in this PR (e.g. internal system URLs, customer names, tenant IDs, or confidential configurations). This is a public repository.

Description

Adds filtering support to list_mcp_tools via a new MCPToolFilter dataclass. The implementation mirrors the existing AgentCardFilter / list_agent_cards pattern:

• ord_ids is applied pre-fetch — non-matching fragments (LoB) or integration dependencies (customer) are skipped
  before any MCP server is queried, saving a network round-trip per excluded server.
• names is applied post-fetch — tool names are only known after querying each MCP server.

Both the LoB and customer flows are supported.

Related Issue

Closes #177

Type of Change

Please check the relevant option:

• Bug fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update
• Code refactoring
• Dependency update

How to Test

1. Run uv run pytest tests/agentgateway/unit/ -v

Checklist

Before submitting your PR, please review and check the following:

• I have read the Contributing Guidelines
• I have verified that my changes solve the issue
• I have added/updated automated tests to cover my changes
• All tests pass locally
• I have verified that my code follows the Code Guidelines
• I have updated documentation (if applicable)
• I have added type hints for all public APIs
• My code does not contain sensitive information (credentials, tokens, etc.)
• I have followed Conventional Commits for commit messages

Breaking Changes

None. The filter parameter defaults to None, so all existing call sites are unaffected.

Additional Notes

N/A

[NicoleMGomes]

can't we receive filter object directly?

[jplbrun]

We can, I'll include a commit changing the places that use name/ord_id to use filter instead. What do you think about me also changing get_agent_cards_lob in this PR so it follows the same patterns?