MCP Simple OpenAI Assistant

Instructions

Implementation Reference

• mcp_simple_openai_assistant/app.py:200-221 (handler)

  MCP tool handler and registration for 'retrieve_assistant'. Calls AssistantManager to fetch assistant details from OpenAI and returns formatted string output.

  @app.tool(
      annotations={
          "title": "Retrieve OpenAI Assistant",
          "readOnlyHint": True
      }
  )
  async def retrieve_assistant(assistant_id: str) -> str:
      """Get detailed information about a specific assistant. 
         The ID required can be retrieved from the list_assistants tool."""
      if not manager:
          raise ToolError("AssistantManager not initialized.")
      try:
          result = await manager.retrieve_assistant(assistant_id)
          return dedent(f"""
          Assistant Details:
          ID: {result.id}
          Name: {result.name}
          Model: {result.model}
          Instructions: {result.instructions}
          """)
      except Exception as e:
          raise ToolError(f"Failed to retrieve assistant {assistant_id}: {e}")

• mcp_simple_openai_assistant/assistant_manager.py:63-65 (helper)

  Core helper method in AssistantManager that directly calls the OpenAI API to retrieve the Assistant object by ID.

  async def retrieve_assistant(self, assistant_id: str) -> Assistant:
      """Get details about a specific assistant."""
      return self.client.beta.assistants.retrieve(assistant_id)