Fatebook MCP Server

Instructions

Implementation Reference

• src/fatebook_mcp/__main__.py:184-251 (handler)

  Implementation of the create_question tool handler. Posts to Fatebook API to create a question, parses the response URL to extract question ID, and returns QuestionReference.

  @mcp.tool()
  async def create_question(
      title: str,
      resolveBy: str,
      forecast: float,
      apiKey: str = "",
      tags: list[str] = [],
      sharePublicly: bool = False,
      shareWithLists: list[str] = [],
      shareWithEmail: list[str] = [],
      hideForecastsUntil: str = "",
  ) -> QuestionReference:
      """Create a new Fatebook question"""
  
      api_key = apiKey or os.getenv("FATEBOOK_API_KEY")
      if not api_key:
          raise ValueError(
              "API key is required (provide as parameter or set FATEBOOK_API_KEY environment variable)"
          )
  
      # Validate forecast parameter
      if not 0 <= forecast <= 1:
          raise ValueError("forecast must be between 0 and 1")
  
      params: ParamsType = {
          "apiKey": api_key,
          "title": title,
          "resolveBy": resolveBy,
          "forecast": forecast,
      }
  
      # Add optional parameters
      if tags:
          params["tags"] = ",".join(tags)
      if sharePublicly:
          params["sharePublicly"] = sharePublicly
      if shareWithLists:
          params["shareWithLists"] = ",".join(shareWithLists)
      if shareWithEmail:
          params["shareWithEmail"] = ",".join(shareWithEmail)
      if hideForecastsUntil:
          params["hideForecastsUntil"] = hideForecastsUntil
  
      try:
          async with httpx.AsyncClient() as client:
              response = await client.post("https://fatebook.io/api/v0/createQuestion", params=params)
              response.raise_for_status()
  
              # Parse the URL from the response to extract title and ID
              url = response.text.strip()
              if url.startswith("https://fatebook.io/q/"):
                  # Extract the slug part after /q/
                  slug = url.replace("https://fatebook.io/q/", "")
  
                  # Split on the last occurrence of -- to separate title and ID
                  if "--" in slug:
                      url_title, question_id = slug.rsplit("--", 1)
                      return QuestionReference(id=question_id, title=title)
                  else:
                      raise ValueError(f"Could not parse question ID from URL: {url}")
              else:
                  raise ValueError(f"Unexpected response format: {url}")
  
      except httpx.HTTPError:
          raise
      except Exception:
          raise

• src/fatebook_mcp/models.py:204-209 (schema)

  Pydantic model defining the output schema (QuestionReference) returned by create_question tool.

  class QuestionReference(BaseModel):
      """Minimal question reference with id and title"""
  
      id: str
      title: str

• src/fatebook_mcp/__main__.py:184-185 (registration)

  MCP tool registration decorator for create_question.

  @mcp.tool()
  async def create_question(