Twist MCP Server

Instructions

Implementation Reference

• src/threads.py:347-369 (handler)

  The main handler function that executes the tool logic: extracts parameters, calls the Twist API 'threads/mark_unread' endpoint via twist_request, and returns success/error messages.

  def twist_threads_mark_unread(
      ctx: Context,
      id: int,
      obj_index: int
  ) -> str:
      """Marks the thread as being unread.
  
      Args:
          id: The id of the thread
          obj_index: The index of the last unread message. A value of -1 marks the whole thread as unread
      """
      all_params = locals()
      token = ctx.request_context.lifespan_context.twist_token
      params = {k: v for k, v in all_params.items() if k != 'ctx' and v is not None}
  
      try:
          logger.info(f"Marking thread with ID: {id} as unread from comment index: {obj_index}")
          twist_request("threads/mark_unread", params=params, token=token, method="POST")
          logger.info(f"Successfully marked thread with ID: {id} as unread")
          return f"Successfully marked thread with ID: {id} as unread from comment index: {obj_index}"
      except Exception as error:
          logger.error(f"Error marking thread as unread: {error}")
          return f"Error marking thread as unread: {str(error)}"

• main.py:42-48 (registration)

  Dynamically registers all functions starting with 'twist_' from src.threads (and inbox) modules as MCP tools using FastMCP's mcp.tool() decorator.

  # Register all tools from tool modules
  for module in [src.inbox, src.threads]:
      for name, func in inspect.getmembers(module, inspect.isfunction):
          if name.startswith('twist_') and func.__module__ == module.__name__:
              logger.info(f"Registering tool: {name}")
              mcp.tool()(func)