X(Twitter) MCP Server

Instructions

Implementation Reference

• src/x_mcp/server.py:157-180 (handler)

  The main handler function that executes the create_draft_thread tool. It validates the input arguments, creates a JSON file for the draft thread in the 'drafts' directory, and returns a TextContent response with the draft ID.

  async def handle_create_draft_thread(arguments: Any) -> Sequence[TextContent]:
      if not isinstance(arguments, dict) or "contents" not in arguments:
          raise ValueError("Invalid arguments for create_draft_thread")
      contents = arguments["contents"]
      if not isinstance(contents, list) or not all(isinstance(item, str) for item in contents):
          raise ValueError("Invalid contents for create_draft_thread")
      try:
          draft = {"contents": contents, "timestamp": datetime.now().isoformat()}
          # Ensure drafts directory exists
          os.makedirs("drafts", exist_ok=True)
          # Save the draft to a file
          draft_id = f"thread_draft_{int(datetime.now().timestamp())}.json"
          with open(os.path.join("drafts", draft_id), "w") as f:
              json.dump(draft, f, indent=2)
          logger.info(f"Draft thread created: {draft_id}")
          return [
              TextContent(
                  type="text",
                  text=f"Draft thread created with ID {draft_id}",
              )
          ]
      except Exception as e:
          logger.error(f"Error creating draft thread: {str(e)}")
          raise RuntimeError(f"Error creating draft thread: {str(e)}")

• src/x_mcp/server.py:63-77 (registration)

  Tool registration in the list_tools() function, defining the name, description, and input schema for create_draft_thread.

  Tool(
      name="create_draft_thread",
      description="Create a draft tweet thread",
      inputSchema={
          "type": "object",
          "properties": {
              "contents": {
                  "type": "array",
                  "items": {"type": "string"},
                  "description": "An array of tweet contents for the thread",
              },
          },
          "required": ["contents"],
      },
  ),

• src/x_mcp/server.py:67-76 (schema)

  Input schema definition for the create_draft_thread tool, specifying an object with a required 'contents' array of strings.

      "type": "object",
      "properties": {
          "contents": {
              "type": "array",
              "items": {"type": "string"},
              "description": "An array of tweet contents for the thread",
          },
      },
      "required": ["contents"],
  },