USCardForum MCP Server

Instructions

Get a mapping of all forum categories.

Returns a CategoryMap object with category_id to category name mapping.
Categories organize topics by subject area.

Common USCardForum categories include sections for:
- Credit card applications and approvals
- Bank account bonuses
- Travel and redemptions
- Data points and experiences

Use category IDs to:
- Filter search results by category
- Understand which section a topic belongs to
- Navigate to specific areas of interest

The mapping includes both main categories and subcategories.

Implementation Reference

• src/uscardforum/server_tools/categories.py:8-29 (handler)

  The @mcp.tool()-decorated handler function that implements the get_categories tool logic, fetching and returning the CategoryMap.

  @mcp.tool()
  def get_categories() -> CategoryMap:
      """
      Get a mapping of all forum categories.
  
      Returns a CategoryMap object with category_id to category name mapping.
      Categories organize topics by subject area.
  
      Common USCardForum categories include sections for:
      - Credit card applications and approvals
      - Bank account bonuses
      - Travel and redemptions
      - Data points and experiences
  
      Use category IDs to:
      - Filter search results by category
      - Understand which section a topic belongs to
      - Navigate to specific areas of interest
  
      The mapping includes both main categories and subcategories.
      """
      return get_client().get_category_map()

• src/uscardforum/models/categories.py:24-47 (schema)

  Pydantic BaseModel defining the output type CategoryMap returned by the get_categories tool.

  class CategoryMap(BaseModel):
      """Mapping of category IDs to names."""
  
      categories: dict[int, str] = Field(
          default_factory=dict, description="ID to name mapping"
      )
  
      def get_name(self, category_id: int) -> str | None:
          """Get category name by ID."""
          return self.categories.get(category_id)
  
      def __getitem__(self, category_id: int) -> str:
          """Get category name by ID."""
          return self.categories[category_id]
  
      def __contains__(self, category_id: int) -> bool:
          """Check if category ID exists."""
          return category_id in self.categories
  
      def items(self):
          """Iterate over category mappings."""
          return self.categories.items()

• src/uscardforum/server_tools/__init__.py:27-27 (registration)

  Import statement that brings the get_categories tool into the server_tools package namespace for registration.

  from .categories import get_categories

• src/uscardforum/server.py:21-21 (registration)

  Explicit import of get_categories in the main server.py file, ensuring the decorated tool is registered with the MCP server.

  get_categories,