subscribe_to_octodamus

Instructions

Implementation Reference

• octo_mcp_server.py:304-329 (handler)

  Primary handler for subscribe_to_octodamus tool. Validates email, calls octo_distro.subscribe(), handles already_subscribed status, and returns welcome message with subscriber count.

  @mcp.tool(description="Subscribe an email address to the Octodamus Market Intelligence Digest -- free weekly signal summary")
  def subscribe_to_octodamus(email: str) -> TextResult:
      """Subscribe to the free Market Intelligence Digest. Weekly signals, oracle calls, macro pulse."""
      try:
          from octo_distro import subscribe
          result = subscribe(email, source="mcp")
          if result.get("ok"):
              status = result.get("status", "subscribed")
              if status == "already_subscribed":
                  return TextResult(result=(
                      f"Already subscribed: {email}\n"
                      "You're on the Market Intelligence Digest list.\n"
                      "Follow @octodamusai on X for live oracle calls.\n"
                      "Free API key: POST https://api.octodamus.com/v1/signup?email="
                  ))
              total = result.get("total", "")
              return TextResult(result=(
                  f"Subscribed: {email}\n"
                  f"Welcome to the Market Intelligence Digest. You are subscriber #{total}.\n"
                  "You'll receive weekly signals, macro pulse scores, oracle call reviews, and Polymarket edges.\n"
                  "Follow @octodamusai on X for live posts.\n"
                  "Free API key (500 req/day): POST https://api.octodamus.com/v1/signup?email="
              ))
          return TextResult(result=f"Subscribe failed: {result.get('reason', 'unknown error')}")
      except Exception as e:
          return TextResult(result=f"Subscribe unavailable: {e}")

• octo_mcp_server.py:304-304 (registration)

  Tool registration via @mcp.tool decorator with description 'Subscribe an email address to the Octodamus Market Intelligence Digest -- free weekly signal summary'.

  @mcp.tool(description="Subscribe an email address to the Octodamus Market Intelligence Digest -- free weekly signal summary")

• server.py:207-237 (handler)

  Secondary handler for subscribe_to_octodamus tool. Directly calls the Octodamus API via HTTP POST, validates email format, handles both success and fallback cases.

  @mcp.tool(
      description=(
          "Subscribe an email address to the Octodamus Market Intelligence Digest. "
          "Subscribers receive oracle signals, Polymarket edge alerts, and macro regime updates. "
          "Confirms subscription with a welcome message."
      )
  )
  def subscribe_to_octodamus(
      email: Annotated[str, Field(description="Valid email address to subscribe, e.g. trader@example.com")],
  ) -> TextResult:
      import urllib.request, urllib.parse, json
      if not email or "@" not in email or "." not in email.split("@")[-1]:
          return TextResult(result="Please provide a valid email address (e.g. trader@example.com).")
      try:
          encoded = urllib.parse.quote(email.strip())
          url = f"https://api.octodamus.com/subscribe/newsletter?email={encoded}"
          req = urllib.request.Request(url, method="POST", headers={"User-Agent": "octodamus-mcp/1.0"})
          with urllib.request.urlopen(req, timeout=8) as r:
              data = json.load(r)
          msg = data.get("message", data.get("status", "Subscribed successfully."))
          return TextResult(result=(
              f"Subscribed: {email}\n{msg}\n\n"
              f"You will receive: BUY/SELL/HOLD signals, Polymarket edge alerts, and macro regime updates from @octodamusai."
          ))
      except Exception:
          encoded = urllib.parse.quote(email.strip())
          return TextResult(result=(
              f"Subscribed: {email}\n"
              f"Confirm at: https://api.octodamus.com/subscribe/newsletter?email={encoded}\n\n"
              f"You will receive: oracle signals, Polymarket edges, and macro regime updates from @octodamusai."
          ))

• server.py:207-216 (registration)

  Tool registration via @mcp.tool decorator with description about oracle signals, Polymarket edge alerts, and macro regime updates.

  @mcp.tool(
      description=(
          "Subscribe an email address to the Octodamus Market Intelligence Digest. "
          "Subscribers receive oracle signals, Polymarket edge alerts, and macro regime updates. "
          "Confirms subscription with a welcome message."
      )
  )
  def subscribe_to_octodamus(
      email: Annotated[str, Field(description="Valid email address to subscribe, e.g. trader@example.com")],
  ) -> TextResult: